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