array_unshift
(PHP 4, PHP 5, PHP 7)
array_unshift — 一つ以上の要素を配列の最初に加える
説明
array_unshift
( array &$array
, mixed ...$values
) : int
array_unshift() は、array
の先頭に指定された要素を加えます。リストの要素は全体として加えられるため、
加えられた要素の順番は変わらないことに注意してください。
配列の数値添字はすべて新たにゼロから振りなおされます。
リテラルのキーについては変更されません。
パラメータ
array- 入力の配列。
values- 加える値。
返り値
処理後の array の要素の数を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 7.3.0 | この関数は、1 つのパラメータでのみ呼び出すことができるようになりました。
前は、少なくとも 2 つのパラメータが必要でした。 |
例
例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
)
