PHP マニュアル: 一つ以上の要素を配列の最後に追加する

int array_push(array &$array, mixed ...$values)

array_pushは、array をスタックとして処理し、渡された変数を array の最後に加えます。配列 array の長さは渡された変数の数だけ増加します。各 value1 毎に以下を繰り返すことと同じ効果があります。


<?php
$array[] = $var;
?>

各 value1 で繰り返されます。

注意: もし配列にひとつの要素を加えるために array_push を使用するなら、関数を呼ぶオーバーヘッドがないので、$array[] = を使用するほうがいいです。

注意: 最初の引数が配列でない場合、array_push は警告を発生させます。これは、PHP 7.1.0 より前のバージョンの、新規配列を生成する場合における $var[] の動作と異なっていました。

処理後の配列の中の要素の数を返します。

バージョン	説明
7.3.0	この関数は、1 つのパラメータでのみ呼び出すことができるようになりました。前は、少なくとも 2 つのパラメータが必要でした。

例1 array_push の例


<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>

上の例の出力は以下となります。

Array
(
    [0] => orange
    [1] => banana
    [2] => apple
    [3] => raspberry
)