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


(PHP 4, PHP 5)

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

Описание

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

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

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

array

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

value1

Первое значение для добавления.

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

Возвращает новое количество элементов в array.

Примеры

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