array_splice
(PHP 4, PHP 5, PHP 7)
array_splice — Efface et remplace une portion de tableau
Description
&$input
, int $offset
[, int $length = count($input)
[, mixed $replacement = array()
]] )
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.
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 conduire en un résultat non prévu lors de l'utilisation d'un objet ouNULLcomme paramètrereplacement.
Liste de paramètres
-
input -
Le tableau d'entrée.
-
offset -
Si
offsetest positif, la série commencera à cet offset dans le tableauinput. Sioffsetest négatif, cette série commencera à l'offsetoffset, mais en commençant à la fin du tableauinput. -
length -
Si
lengthest donné et positif, alors la série aura autant d'éléments. Silengthest donné et négatif, les éléments seront pris dans l'ordre inverse. Silengthest omis, la séquence supprimera tous les éléments du tableau, depuis l'offsetoffsetjusqu'à la fin du tableau. Si le paramètrelengthest spécifié et vaut zéro, aucun élément ne sera supprimé. Conseil : pour supprimer tous les éléments du tableau depuisoffsetjusqu'à la fin, même si un tableau de remplacementreplacementest spécifié, utilisez count($input) à la place delength. -
replacement -
Si
replacementest précisé, alors les éléments supprimés sont remplacés par les éléments de ce tableau.Si l'
offsetetlengthsont tels que la taille du tableau ne change pas, alors les éléments du tableau de remplacementreplacementsont insérés à partir de l'offsetoffset. Notez que les clés numériques deinputne sont pas préservées.Si le tableau de remplacement
replacementne contient qu'un seul élément, il n'est pas obligatoire de forcer le type en tableau avec array(), à moins que cette variable ne soit elle-même un tableau, un objet ouNULL.
Exemples
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);
?>
Voir aussi
- array_slice() - Extrait une portion de tableau
- unset() - Détruit une variable
- array_merge() - Fusionne plusieurs tableaux en un seul
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-array-splice.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
