array_splice

(PHP 4, PHP 5, PHP 7)

array_spliceEfface et remplace une portion de tableau

Description

array_splice ( array &$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 replacement n'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 ou NULL comme paramètre replacement.

Liste de paramètres

input

Le 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.

Valeurs de retour

Retourne le tableau contenant les éléments extrait.

Exemples

Exemple #1 Exemple avec array_splice()

<?php
$input 
= array("red""green""blue""yellow");
array_splice($input2);
// $input is now array("red", "green")

$input = array("red""green""blue""yellow");
array_splice($input1, -1);
// $input is now array("red", "yellow")

$input = array("red""green""blue""yellow");
array_splice($input1count($input), "orange");
// $input is now array("red", "orange")

$input = array("red""green""blue""yellow");
array_splice($input, -11, array("black""maroon"));
// $input is now array("red", "green",
//          "blue", "black", "maroon")

$input = array("red""green""blue""yellow");
array_splice($input30"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($inputcount($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($input01);

//insérer deux éléments au début de $input
array_unshift($input$x$y);
array_splice($input00, 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$x1$y);

?>

Voir aussi