SYNCER

SYNCER

array_push() - 配列の末尾に要素を追加する

公開日:

array_pushは、配列の末尾に要素を追加する関数です。この関数は、元の配列を変更します。キーが数値の場合、0から振り直しされます。1つだけ要素を追加する場合は$a[]=$bとした方がパフォーマンスがいい。

構文

int array_push ( array &$array , mixed $value1 [, mixed $... ] )

パラメータ

&$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()の挙動を確認して下さい。

int(4)

array(4) {
  [0]=>
  string(1) "a"
  [1]=>
  string(1) "b"
  [2]=>
  string(1) "c"
  [3]=>
  string(1) "A"
}

参考リンク

  • PHP - 公式マニュアル。