(PHP 4, PHP 5, PHP 7)
array_splice — Efface et remplace une portion de tableau
&$input
, int $offset
[, int $length = count($input)
[, mixed $replacement = array()
]] ) : array
array_splice() supprime les éléments
désignés par offset et
length du tableau input et
les remplacent par les éléments du tableau
replacement, si ce dernier est fournit.
Notez que les clés numériques de input
ne sont pas préservées.
Note: Si
replacementn'est pas un tableau, il en deviendra un par transtypage (i.e.(array) $replacement). Cela peut produire des résultats innatendus lors de l'utilisation d'un objet ouNULLcomme paramètrereplacement.
inputLe tableau d'entrée.
offset
Si offset est positif, le début de la section
à supprimmer sera à cette position en partant du début du tableau
input.
Si offset est négatif, le début de la section
à supprimmer sera à cette position en partant de la fin du tableau
input.
length
Si length est omis, tous les éléments du tableau
depuis la position offset jusqu'à la fin du
tableau seront supprimer.
Si length est fournit et positif,
alors autant d'éléments seront supprimés.
Si length est fournit et négatif,
alors autant d'éléments seront supprimés de la fin du tableau.
Si length est fournit et vaut zéro,
alors aucun élément sera supprimé.
Astuce : pour tout supprimer depuis la position offset
jusqu'à la fin du tableau lorsque replacement est aussi
fournit, utilisez COUNT en tant que paramètre pour length.
replacement
Si replacement est fournit, alors les
éléments supprimés sont remplacés par les éléments de ce tableau.
Si l'offset et length
sont tels que rien est supprimer, alors les éléments du tableau
replacement sont insérés à la position
offset.
Notez que les clés du tableau replacement
ne sont pas préservées.
Si replacement est seulement un élément il n'est pas
néccessaire d'entourer l'élément avec array() ou des crochets,
à moins que l'élément ne soit elle-même un tableau, un objet ou NULL.
Retourne le tableau contenant les éléments extrait.
Exemple #1 Exemple avec array_splice()
<?php
$input = array("red", "green", "blue", "yellow");
array_splice($input, 2);
// $input is now array("red", "green")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, -1);
// $input is now array("red", "yellow")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, count($input), "orange");
// $input is now array("red", "orange")
$input = array("red", "green", "blue", "yellow");
array_splice($input, -1, 1, array("black", "maroon"));
// $input is now array("red", "green",
// "blue", "black", "maroon")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 3, 0, "purple");
// $input is now array("red", "green",
// "blue", "purple", "yellow");
?>
Exemple #2 Exemple avec array_splice()
L'exemple suivant modifie les valeurs de $input de la même façon :
<?php
// ajouter deux éléments à $input
array_push($input, $x, $y);
array_splice($input, count($input), 0, array($x, $y));
// supprimer le dernier élément à $input
array_pop($input);
array_splice($input, -1);
// supprimer le premier élément à $input
array_shift($input);
array_splice($input, 0, 1);
//insérer deux éléments au début de $input
array_unshift($input, $x, $y);
array_splice($input, 0, 0, array($x, $y));
// remplace la valeur dans $input à l'index $x
$input[$x] = $y; // pour les tableaux dont les clés sont égales à l'offset
array_splice($input, $x, 1, $y);
?>