array_spliceEfface et remplace une portion de tableau
&reftitle.description;
arrayarray_splicearrayarrayintoffsetintnulllength&null;mixedreplacement[]array_splice supprime les éléments
désignés par offset et
length du tableau array et
les remplacent par les éléments du tableau
replacement, si ce dernier est fourni.
Les clés numériques dans array ne sont pas préservées.
Si replacement n'est pas un tableau, il en
deviendra un par transtypage
(i.e. (array) $replacement). Cela peut produire des résultats
inattendus lors de l'utilisation d'un objet ou &null; comme
paramètre replacement.
&reftitle.parameters;
array
Le tableau d'entrée.
offset
Si offset est positif, le début de la section
à supprimer sera à cette position en partant du début du tableau
array.
Si offset est négatif, le début de la section
à supprimer sera à cette position en partant de la fin du tableau
array.
length
Si length est omis, tous les éléments du tableau
depuis la position offset jusqu'à la fin du
tableau seront supprimés.
Si length est fourni et positif,
alors autant d'éléments seront supprimés.
Si length est fourni et négatif,
alors autant d'éléments seront supprimés de la fin du tableau.
Si length est fourni et vaut zéro,
alors aucun élément sera supprimé.
Pour tout supprimer depuis la position offset
jusqu'à la fin du tableau lorsque replacement
est aussi fourni, utiliser count($input) pour length.
replacement
Si le &array; replacement est fourni, alors les
éléments supprimés sont remplacés par les éléments de ce &array;.
Si l'offset et length
sont tels que rien est supprimé, alors les éléments du &array;
replacement sont insérés à la position
offset.
Les clés du &array; replacement ne sont pas préservées.
Si replacement est seulement un élément il n'est pas
nécessaire d'entourer l'élément avec array() ou des crochets,
à moins que l'élément ne soit lui-même un tableau, un objet ou &null;.
&reftitle.returnvalues;
Retourne un &array; contenant les éléments extrait.
&reftitle.changelog;
&Version;&Description;8.0.0length est désormais nullable.
&reftitle.examples;
Exemples avec array_splice
]]>
&example.outputs;
string(3) "red"
[1]=>
string(5) "green"
}
array(2) {
[0]=>
string(3) "red"
[1]=>
string(6) "yellow"
}
array(2) {
[0]=>
string(3) "red"
[1]=>
string(6) "orange"
}
array(5) {
[0]=>
string(3) "red"
[1]=>
string(5) "green"
[2]=>
string(4) "blue"
[3]=>
string(5) "black"
[4]=>
string(6) "maroon"
}
]]>
Déclaration équivalentes à des exemples de array_splice divers
Les déclarations suivantes sont équivalentes :
]]>
&reftitle.seealso;
array_mergearray_sliceunset