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