array_splice
Entfernt einen Teil eines Arrays und ersetzt ihn durch etwas
anderes
&reftitle.description;
arrayarray_splicearrayarrayintoffsetintnulllength&null;mixedreplacement[]
Entfernt die durch offset und
length angegebenen Elemente aus dem Array
array, und ersetzt diese durch die Elemente
des Arrays replacement, wenn angegeben.
Numerische Schlüssel in
array werden nicht erhalten.
Wenn replacement kein Array ist, wird es in
ein Array umgewandelt
(dies entspricht (array) $parameter). Dies kann zu
unerwartetem Verhalten führen, wenn replacement
ein Objekt oder &null; ist.
&reftitle.parameters;
array
Das Eingabe-Array.
offset
Ist offset positiv, beginnt der zu
entfernende Bereich bei diesem Offset vom Anfang des Arrays
array.
Ist offset
negativ, beginnt der zu entfernende Bereich so viele Elemente
vor dem Ende des Arrays array.
length
Ist length nicht angegeben, wird alles
von offset bis zum Ende des Arrays
entfernt.
Ist length angegeben und
positiv, werden so viele Elemente entfernt.
Ist length angegeben und negativ, so ist das
Ende des entfernten Bereichs so viele Elemente vor dem Ende des
Array.
Wenn length angegeben und 0 ist, werden
keine Elemente entfernt.
Um alles von offset bis zum
Ende des Arrays zu entfernen, wenn
replacement ebenfalls angegeben ist,
verwenden Sie count($input) als
length.
replacement
Ist das Array replacement angegeben,
werden die entfernten Elemente durch die Elemente dieses Arrays
ersetzt.
Sind offset und
length so angegeben, dass nichts entfernt
wird, werden die Elemente von replacement
an der von offset spezifizierten Stelle
eingefügt.
Schlüssel werden bei der Ersetzung nicht erhalten.
Wenn replacement nur aus einem Element
besteht, ist es nicht notwendig, array() oder eckige Klammern
anzugeben, sofern das Element nicht selbst ein Array, ein Objekt
oder &null; ist.
&reftitle.returnvalues;
Gibt ein Array zurück, das aus den ausgeschnittenen Elementen
besteht.
&reftitle.changelog;
&Version;&Description;8.0.0length ist jetzt nullbar.
&reftitle.examples;
<function>array_splice</function>-Beispiele
]]>
&example.outputs;
string(3) "rot"
[1]=>
string(5) "grün"
}
array(2) {
[0]=>
string(3) "rot"
[1]=>
string(4) "gelb"
}
array(2) {
[0]=>
string(3) "rot"
[1]=>
string(6) "orange"
}
array(5) {
[0]=>
string(3) "rot"
[1]=>
string(5) "grün"
[2]=>
string(4) "blau"
[3]=>
string(7) "schwarz"
[4]=>
string(5) "braun"
}
]]>
<function>array_splice</function>-Beispiele zu gleichwertigen Anweisungen
Die folgenden Anweisungen sind gleichwertig:
]]>
&reftitle.seealso;
array_mergearray_sliceunset