array_push() - 配列の末尾に要素を追加する
公開日:
array_push
は、配列の末尾に要素を追加する関数です。この関数は、元の配列を変更します。キーが数値の場合、0から振り直しされます。1つだけ要素を追加する場合は$a[]=$b
とした方がパフォーマンスがいい。
構文
パラメータ
&$array
対象の配列。
$value1
末尾に追加する要素。
$...
複数の要素を追加したい場合、第3引数以降に指定できる。
返り値
int
末尾に要素を追加した後の、配列の要素数。
サンプルコード
末尾に要素を追加する
配列の末尾に要素を追加します。
php
<?php
// 元の配列
$queue = [ "a", "b", "c" ] ;
// 実行
$result = array_push( $queue, "A" ) ;
// 結果
var_dump( $result ) ; // 返り値
echo "\n" ;
print_r( $queue ) ; // 実行後の配列
結果 (出力内容) - PHP7.0.21
int(4)
Array
(
[0] => a
[1] => b
[2] => c
[3] => A
)
複数の要素を追加する
1つの要素を追加する場合、$a[]=$b
の方が使い勝手もパフォーマンスもよく、あまり意味がありません。この関数は、第3引数以降を指定することで、複数の値をまとめて追加できます。
php
<?php
// 元の配列
$queue = [ "a", "b", "c" ] ;
// 実行
$result = array_push( $queue, "A", "B", "C" ) ;
// 結果
var_dump( $result ) ; // 返り値
echo "\n" ;
print_r( $queue ) ; // 実行後の配列
結果 (出力内容) - PHP7.0.21
int(6)
Array
(
[0] => a
[1] => b
[2] => c
[3] => A
[4] => B
[5] => C
)
サンドボックス
ソースコードを編集してarray_push()
の挙動を確認して下さい。
参考リンク
- PHP - 公式マニュアル。