(PHP 4, PHP 5, PHP 7, PHP 8)
array_push — 一つ以上の要素を配列の最後に追加する
array_push()は、array
をスタックとして処理し、渡された変数を
array の最後に加えます。配列
array の長さは渡された変数の数だけ増加します。
各 value1
毎に以下を繰り返すことと同じ効果があります。
<?php
$array[] = $var;
?>
value1 で繰り返されます。
注意: もし配列にひとつの要素を加えるために array_push() を使用するなら、 関数を呼ぶオーバーヘッドがないので、
$array[] =を使用するほうがいいです。
注意: 最初の引数が配列でない場合、array_push() は警告を発生させます。これは、PHP 7.1.0 より前のバージョンの、 新規配列を生成する場合における
$var[]の動作と異なっていました。
array入力の配列。
values
array の最後に追加する値。
処理後の配列の中の要素の数を返します。
| バージョン | 説明 |
|---|---|
| 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
)