array_shift
(PHP 4, PHP 5)
array_shift — Dépile un élément au début d'un tableau
Description
array_shift() extrait la première valeur d'un tableau et la retourne, en raccourcissant le tableau d'un élément, et en déplaçant tous les éléments vers le bas. Toutes les clés numériques seront modifiées pour commencer à zéro.
Note: Cette fonction remet le pointeur au début du tableau d'entrée (équivalent de reset()).
Liste de paramètres
-
array
-
Le tableau d'entrée.
Valeurs de retour
Retourne la valeur dépilée, ou NULL
si le tableau est vide ou si la
valeur d'entrée n'est pas un tableau.
Exemples
Exemple #1 Exemple avec array_shift()
<?php $stack = array("orange", "banana", "apple", "raspberry"); $fruit = array_shift($stack); print_r($stack); ?>
L'exemple ci-dessus va afficher :
Array ( [0] => banana [1] => apple [2] => raspberry )
et orange a été placé dans $fruit.
Voir aussi
- array_unshift() - Empile un ou plusieurs éléments au début d'un tableau
- array_push() - Empile un ou plusieurs éléments à la fin d'un tableau
- array_pop() - Dépile un élément de la fin d'un tableau