array_shift
Удаляет первый элемент массива и возвращает его.
Синтаксис
array_shift(array &$array): mixedПараметры
| Параметр | Тип | Описание |
|---|---|---|
| $array | array | Массив, который изменяется. |
Возвращаемое значение
mixedУдалённый элемент или `null` для пустого массива.
Примеры
Очередь: первый пришёл — первый ушёл:
<?php
$queue = ['Anna', 'Oleg', 'Ivan'];
$next = array_shift($queue);
echo $next, ' | ', implode(', ', $queue);Результат:
Anna | Oleg, IvanЧисловые ключи перенумеровываются:
<?php
$numbers = [10, 20, 30];
array_shift($numbers);
echo json_encode($numbers);Результат:
[20,30]Примечания
На больших массивах функция медленная: все оставшиеся элементы сдвигаются.
См. также
- array_pop — Удаляет последний элемент массива и возвращает его.
- array_unshift — Добавляет элементы в начало массива.
В учебнике
- Массивы — Списки и ассоциативные массивы в PHP — создание, изменение, перебор и полезные функции.