array_unshift

(PHP 4, PHP 5)

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

Описание

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

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

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

Пример #1 Пример использования array_unshift()


<?php

$queue = array("orange", "banana");

array_unshift($queue, "apple", "raspberry");

?>

В результате массив $queue будет содержать следующие элементы:



Array

(

    [0] => apple

    [1] => raspberry

    [2] => orange

    [3] => banana

)

См. также array_shift(), array_push() и array_pop().