array_shift
(PHP 4, PHP 5)
array_shift — Извлечь первый элемент массива
Описание
mixed array_shift
( array $&array
)
array_shift() извлекает первое значение массива array и возвращает его, сокращая размер array на один элемент. Все числовые ключи будут изменены таким образом, что нумерация массива начнётся с нуля, в то время как строковые ключи останутся прежними. Если array пуст (или не является массивом), будет возвращён NULL.
Note: Эта функция сбрасывает указатель массива после использования.
Example#1 Пример использования array_shift()
<?php
$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_shift($stack);
print_r($stack);
?>
В результате в массиве $stack останется 3 элемента:
Array ( [0] => banana [1] => apple [2] => raspberry )
и значение orange будет присвоено переменной $fruit.
См. также array_unshift(), array_push() и array_pop().