array_unshift
Добавляет элементы в начало массива.
Синтаксис
array_unshift(array &$array, mixed ...$values): intПараметры
| Параметр | Тип | Описание |
|---|---|---|
| $array | array | Массив, который изменяется. |
| ...$values | mixed | Добавляемые значения. |
Возвращаемое значение
intНовое количество элементов.
Примеры
Элемент в начало списка:
<?php
$steps = ['cook', 'eat'];
array_unshift($steps, 'buy');
echo implode(' > ', $steps);Результат:
buy > cook > eatНесколько значений сохраняют свой порядок:
<?php
$numbers = [3];
array_unshift($numbers, 1, 2);
echo implode(', ', $numbers);Результат:
1, 2, 3Примечания
Числовые ключи перенумеровываются с нуля, строковые остаются прежними.
См. также
- array_shift — Удаляет первый элемент массива и возвращает его.
- array_push — Добавляет элементы в конец массива.
Вопросы и ответы по теме
В учебнике
- Массивы — Списки и ассоциативные массивы в PHP — создание, изменение, перебор и полезные функции.