PHP array_splice() Fonction
Exemple
Supprimez des éléments d'un tableau et remplacez-les par de nouveaux éléments :
<?php
$a1=array("a"=>"rouge","b"=>"vert","c"=>"bleu","d"=>"jaune");
$a2=array("a"=>"violet","b"=>"orange");
array_splice($a1,0,2,$a2);
print_r($a1);
?> Définition et Utilisation
La fonction array_splice() supprime des éléments sélectionnés d'un tableau et les remplace par de nouveaux éléments. La fonction retourne également un tableau contenant les éléments supprimés.
Astuce : Si la fonction ne supprime aucun élément (longueur=0), le tableau remplacé sera inséré à partir de la position du paramètre de départ (voir Exemple 2).
Remarque : Les clés du tableau remplacé ne sont pas préservées.
Syntaxe
array_splice( tableau, début, longueur, tableau ) Valeurs des Paramètres
| Paramètre | Description |
|---|---|
| tableau | Requis. Spécifie un tableau. |
| début | Requis. Valeur numérique. Spécifie où la fonction commencera à supprimer des éléments. 0 = le premier élément. Si cette valeur est définie sur un nombre négatif, la fonction commencera à partir de cette distance du dernier élément. -2 signifie commencer au deuxième dernier élément du tableau. |
| longueur | Optionnel. Valeur numérique. Spécifie combien d'éléments seront supprimés, ainsi que la longueur du tableau retourné. Si cette valeur est définie sur un nombre négatif, la fonction s'arrêtera à cette distance du dernier élément. Si cette valeur n'est pas définie, la fonction supprimera tous les éléments, en commençant à partir de la position définie par le paramètre de début. |
| tableau | Optionnel. Spécifie un tableau avec les éléments qui seront insérés dans le tableau original. Si c'est un seul élément, cela peut être une chaîne, et cela n'a pas besoin d'être un tableau. |
Détails Techniques
| Valeur de Retour : | Retourne le tableau constitué des éléments extraits. |
|---|---|
| Version PHP : | 4+ |
Plus d'Exemples
Exemple 1
Le même exemple que celui en haut de la page, mais la sortie est le tableau retourné :
<?php
$a1=array("a"=>"rouge","b"=>"vert","c"=>"bleu","d"=>"jaune");
$a2=array("a"=>"violet","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
?> Exemple 2
Avec le paramètre de longueur défini sur 0 :
<?php
$a1=array("0"=>"rouge","1"=>"vert");
$a2=array("0"=>"violet","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
?>