Руководство по PHP
Пред. |  | След.

# array_shift

(PHP 4 , PHP 5)

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

## Описание

mixed array_shift ( array &array )

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

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

Пример 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().

Пред. | Начало | След.
array_search | Уровень выше | array_slice