array_push

関数の概要

PHPの array_push 関数は、配列の末尾に1つ以上の要素を追加するための便利な関数です。新しい要素を手軽に配列に追加できるため、動的に配列を拡張したい場合に非常に役立ちます。

パラメータの説明

  • array（参照渡し）: 要素を追加したい対象の配列を指定します。この配列は参照渡しのため、関数実行後に元の配列も更新されます。
  • values（可変長引数）: 配列に追加したい要素を1つ以上指定します。複数の要素を一度に追加できます。

戻り値

追加後の配列の要素数（整数）を返します。これを利用すると、配列の現在のサイズを取得することもできます。

使用例

基本的な使い方

$fruits = ['りんご', 'バナナ'];
array_push($fruits, 'みかん');
print_r($fruits);

この例では、array_push で「みかん」を配列の末尾に追加しています。結果は ['りんご', 'バナナ', 'みかん'] となります。

複数要素を一度に追加する

$numbers = [1, 2];
array_push($numbers, 3, 4, 5);
print_r($numbers);

複数の要素「3」「4」「5」を一度に追加しています。複数の値を同時に追加できるため、手間が省けます。

戻り値で配列の長さを取得する

$colors = ['赤', '青'];
$newLength = array_push($colors, '緑');
echo $newLength; // 出力: 3

このように array_push の戻り値を使って、配列の現在の要素数を取得することもできます。

関連する関数

  • array_unshift – 配列の先頭に要素を追加する
  • array_pop – 配列の末尾の要素を取り除く
  • array_shift – 配列の先頭の要素を取り除く
  • []（配列の[]構文） – 末尾に1つの要素を追加する方法

まとめ

array_push はPHPで配列の末尾に複数の要素を簡単に追加したい場合に使う便利な関数です。参照渡しで配列を直接更新し、追加後の要素数を返すため、要素数の把握にも役立ちます。実務で動的に配列を扱うシーンが多い場合は、特に覚えておきたい関数のひとつです。

スポンサーリンク