array_shift

(PHP 4, PHP 5)

array_shift - Извлечь первый элемент массива

Описание

mixed array_shift ( array &array )

array_shift() извлекает первое значение массива array и возвращает его, сокращая размер array на один элемент. Все числовые ключи будут изменены таким образом, что нумерация массива начнётся с нуля, в то время как строковые ключи останутся прежними. Если array пуст (или не является массивом), будет возвращён NULL.

Замечание: Эта функция сбрасывает указатель массива после использования.

Пример 1. Пример использования array_shift()

$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_shift($stack);
print_r($stack);

В результате в массиве $stack останется 3 элемента:

и значение orange будет присвоено переменной $fruit.

Смотрите также array_unshift(), array_push() и array_pop().

Все функции array
Описание на ru2.php.net
Описание на php.ru