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() も参照ください。