array_unshift

(PHP 4, PHP 5, PHP 7)

array_unshiftДобавляет один или несколько элементов в начало массива

Описание

array_unshift ( array &$array [, mixed $... ] ) : int

array_unshift() добавляет переданные в качестве аргументов элементы в начало массива array. Обратите внимание, что список элементов добавляется целиком, то есть порядок элементов сохраняется. Все числовые ключи будут изменены таким образом, что нумерация массива будет начинаться с нуля, в то время как строковые ключи останутся прежними.

Список параметров

array

Входной массив.

...

Значения для добавления.

Возвращаемые значения

Возвращает новое количество элементов в 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() - Извлекает последний элемент массива