Php/docs/function.array-push

• PHP Manual
• 配列 関数
• 一つ以上の要素を配列の最後に追加する

array_push

(PHP 4, PHP 5, PHP 7)

array_push — 一つ以上の要素を配列の最後に追加する

説明

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

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

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

各 value1 で繰り返されます。

注意:

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

注意:

最初の引数が配列でない場合、array_push() は警告を発生させます。これは新規配列を生成する場合における $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
)

参考

• array_pop() - 配列の末尾から要素を取り除く
• array_shift() - 配列の先頭から要素を一つ取り出す
• array_unshift() - 一つ以上の要素を配列の最初に加える