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