PHP array_splice()Fonctions
Référence complète des tableaux PHP
Exemples
Supprimer des éléments d'un tableau et les remplacer par de nouveaux éléments :
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"jaune");
$a2=array("a"=>"violet","b"=>"orange");
array_splice($a1,0,2,$a2);
print_r($a1);
Exécuter l'exemple »
Définition et utilisation
La fonction array_splice() supprime les éléments sélectionnés d'un tableau et les remplace par de nouveaux éléments. La fonction renvoie également un tableau des éléments supprimés.
Astuce :Si la fonction ne supprime aucun élément (length=0), le tableau de remplacement sera inséré à la position du paramètre start (voir Exemple 2).
Remarque :Les noms de clés dans le tableau de remplacement ne sont pas conservés.
Syntaxe
array_splice(array1,start,length,array2)
| Paramètre | Description |
|---|---|
| array1 | Obligatoire. Spécifie le tableau. |
| start | Obligatoire. Valeur numérique. Spécifie la position de départ pour la suppression d'éléments. 0 = le premier élément. Si la valeur est définie comme positive, la suppression commence à partir du décalage spécifié par cette valeur dans le tableau. Si la valeur est définie comme négative, la suppression commence à partir du décalage compté à rebours depuis la fin du tableau. -2 signifie commencer à partir du deuxième élément depuis la fin du tableau. |
| longueur | Facultatif. Valeur numérique. Spécifie le nombre d'éléments à supprimer, ainsi que la longueur du tableau retourné. Si cette valeur est définie comme positive, ce nombre d'éléments est supprimé. Si cette valeur est définie comme négative, tous les éléments depuis start jusqu'à l'élément situé à length de la fin du tableau sont supprimés. Si cette valeur n'est pas définie, tous les éléments depuis la position définie par le paramètre start jusqu'à la fin du tableau sont supprimés. |
| array2 | Facultatif. Spécifie un tableau avec les éléments à insérer dans le tableau d'origine. S'il n'y a qu'un seul élément, il peut être défini comme une chaîne sans avoir besoin d'être défini comme un tableau. |
Détails techniques
| Valeur de retour : | Retourne un tableau contenant les éléments extraits. |
|---|---|
| Version de PHP : | 4+ |
Plus d’exemples
Exemple 1
Identique à l'exemple plus haut sur cette page, mais affiche le tableau retourné :
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"jaune");
$a2=array("a"=>"violet","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
Exécuter l'exemple »
Exemple 2
Avec le paramètre length défini à 0 :
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
Exécuter l'exemple »
Référence complète des tableaux PHP Autres extensions