PHP - Funktion array_splice()
Beispiel
Elemente aus einem Array entfernen und durch neue Elemente ersetzen:
<?php
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
array_splice($a1,0,2,$a2);
print_r($a1);
?>
Definition und Verwendung
Die Funktion array_splice() entfernt ausgewählte Elemente aus einem Array und ersetzt sie durch neue Elemente. Die Funktion gibt auch ein Array mit den entfernten Elementen zurück.
Tipp: Wenn die Funktion keine Elemente entfernt (Länge=0), wird das ersetzte Array ab der Position des Startparameters eingefügt (siehe Beispiel 2).
Hinweis: Die Schlüssel im ersetzten Array werden nicht beibehalten.
Syntax
array_splice(array, start, length, array)
Parameterwerte
| Parameter | Description |
|---|---|
| array | Required. Specifies an array |
| start | Required. Numeric value. Specifies where the function will start
removing elements.
0 = the first element.
If this value is set to a negative number, the function will start that far from the last element.
-2 means start at the second last element of the array. |
| length | Optional. Numeric value. Specifies how many elements will
be removed, and also length of the returned array.
If this value is set to a negative number, the function will stop that far from the last element. If this value is not set, the function will
remove all elements, starting from the position set by the start-parameter.
|
| array | Optional. Specifies an array with the elements that will be inserted to the original array. If it's only one element, it can be a string, and does not have to be an array. |
Technische Details
| Rückgabewert: | Gibt das Array zurück, das aus den extrahierten Elementen besteht |
|---|---|
| PHP-Version: | 4+ |
Mehr Beispiele
Beispiel 1
Dasselbe Beispiel wie das Beispiel oben auf der Seite, aber die Ausgabe ist das zurückgegebene Array:
<?php
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
?>
Beispiel 2
Wenn der Längenparameter auf 0 gesetzt ist:
<?php
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
?>
❮ PHP-Array-Referenz