array_shift

(PHP 4 , PHP 5)

array_shift --  Dépile un élément au début d'un tableau

Description

mixed array_shift ( array &array )

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 clefs numériques seront modifiées pour commencer à zéro. Si array est vide, ou n'est pas un tableau, array_shift() retourne NULL.

Note : Cette fonction remet le pointeur au début du tableau (équivalent de reset()).

Exemple 1. Exemple avec array_shift()

<?php
$stack
= array("orange", "banane", "pomme", "bleuet");
$fruit = array_shift($stack);
print_r($stack);
?>

$stack contient encore trois éléments :

Array
(
    [0] => banane
    [1] => pomme
    [2] => bleuet
)

et orange a été placé dans $fruit.

Voir aussi array_unshift(), array_push() et array_pop().