PHP array_splice()Funktionen
Vollständige PHP-Array-Referenz
Beispiele
Entfernt Elemente aus einem Array und ersetzt sie durch neue Elemente:
$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);
Beispiel ausführen »
Definition und Verwendung
Die Funktion array_splice() entfernt ausgewählte Elemente aus einem Array und ersetzt sie durch neue Elemente. Die Funktion gibt außerdem ein Array der entfernten Elemente zurück.
Tipp:Wenn die Funktion keine Elemente entfernt (length=0), wird das Ersatzarray ab der Position des start-Parameters eingefügt (siehe Beispiel 2).
Hinweis:Schlüsselnamen im Ersatzarray werden nicht beibehalten.
Syntax
array_splice(array1,start,length,array2)
| Parameter | Beschreibung |
|---|---|
| array1 | Erforderlich. Gibt das Array an. |
| start | Erforderlich. Numerischer Wert. Gibt die Startposition zum Entfernen von Elementen an. 0 = das erste Element. Wenn der Wert positiv gesetzt ist, beginnt das Entfernen beim Offset, der durch diesen Wert im Array angegeben wird. Wenn der Wert negativ gesetzt ist, beginnt das Entfernen beim Offset, vom Ende des Arrays rückwärts gezählt. -2 bedeutet, vom zweiten Element vom Ende des Arrays an zu beginnen. |
| length | Optional. Numerischer Wert. Gibt die Anzahl der zu entfernenden Elemente an und auch die Länge des zurückgegebenen Arrays. Wenn dieser Wert positiv gesetzt ist, wird diese Anzahl von Elementen entfernt. Wenn dieser Wert negativ gesetzt ist, werden alle Elemente von start bis zu dem Element entfernt, das length vom Ende des Arrays entfernt ist. Wenn dieser Wert nicht gesetzt ist, werden alle Elemente von der durch den start-Parameter festgelegten Position bis zum Ende des Arrays entfernt. |
| array2 | Optional. Gibt ein Array mit den Elementen an, die in das ursprüngliche Array eingefügt werden sollen. Wenn es nur ein Element gibt, kann es als Zeichenkette festgelegt werden, ohne als Array festgelegt werden zu müssen. |
Technische Details
| Rückgabewert: | Gibt ein Array zurück, das die extrahierten Elemente enthält. |
|---|---|
| PHP-Version: | 4+ |
Weitere Beispiele
Beispiel 1
Wie das frühere Beispiel auf dieser Seite, gibt aber das zurückgegebene Array aus:
$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 ausführen »
Beispiel 2
Wenn der Parameter length auf 0 gesetzt ist:
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
Beispiel ausführen »
Vollständige PHP-Array-Referenz Andere Erweiterungen