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

# array_shift

(PHP 4, PHP 5)

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

## Описание

mixed array_shift ( array &array )

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

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

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