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

# array_push

(PHP 4, PHP 5, PHP 7, PHP 8)

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

### 説明

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

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
    )

### 参考

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open