array_splice

Description

array_splice() supprime les éléments désignés par offset et length du tableau input et les remplace par les éléments du tableau replacement, si ce dernier est présent.

Si offset est positif, la série commencera à cet offset dans le tableau array. Si offset est négatif, cette série commencera à líoffset offset mais en commencant à la fin du tableau.

Si length est donné et positif, alors la série aura autant díéléments. Si Si length est donné et négatif, les éléments seront pris dans líordre inverse. Si length . est omis, la séquence lira tous les éléments du tableau, depuis líoffset précisé jusquíà la fin du tableau. Conseil : pour supprimer tous les éléments du tableau depuis offset jusquíà la fin, même si un tableau de remplacement replacement est spécifié, utilisez count($input) à la place de length.

Si replacement est précisé, alors les éléments supprimés sont remplacés par les éléments de ce tableau. Si offset et length sont tels que la taille du tableau ne change pas, alors les éléments du tableau de remplacement replacement sont insérés à partir de líoffset offset. Conseil : si le tableau de remplacement ne contient quíun seul élément, il níest pas obligatoire de forcer le type à array avec array(), à moins que cette variable ne soit elle même un tableau.

Les exemples suivants remplissent la même fonction :

array_push($input, $x, $y)     array_splice($input, count($input), 0, array($x, $y))
array_pop($input)              array_splice($input, -1)
array_shift($input)            array_splice($input, 0, 1)
array_unshift($input, $x, $y)  array_splice($input, 0, 0, array($x, $y))
$a[$x] = $y                    array_splice($input, $x, 1, $y)
     

Retourne une tableau contenant les éléments supprimés.

$input = array("rouge", "vert", "bleu", "jaune");

array_splice($input, 2);      // $input contient desormais ("rouge", "vert")
array_splice($input, 1, -1);  // $input contient desormais ("rouge", "jaune")
array_splice($input, 1, count($input), "orange");  // $input contient desormais ("rouge", "orange")
array_splice($input, -1, 1, array("noire", "marron")); // $input contient desormais ("rouge", "vert", "bleu", "noir", "marron")
      

Voir aussi array_slice().