PHP array_replace()関数

PHP Array 参考手册完全な PHP Array リファレンスマニュアル

例

2番目の配列($a2)の値を使用して、最初の配列($a1)の値を置き換えます:

<?php
$a1=array("red","green");
$a2=array("blue","yellow");
print_r(array_replace($a1,$a2));
?>

例を実行 »

定義と使用法

array_replace() 関数は、後方の配列の値を使用して最初の配列の値を置き換えます。

ヒント:関数には、1つの配列または複数の配列を渡すことができます。

キーが最初の配列 array1 と2番目の配列 array2 の両方に存在する場合、最初の配列 array1 の値は2番目の配列 array2 の値で置き換えられます。キーが最初の配列 array1 にのみ存在する場合は、そのまま保持されます。(下の例 1 を参照)

キーが2番目の配列 array2 に存在するが、最初の配列 array1 には存在しない場合、その要素は最初の配列 array1 に作成されます。(下の例 2 を参照)

複数の置換配列を渡した場合、それらは順番に処理され、後方の配列の値が前方の配列の値を上書きします。(下の例 3 を参照)

ヒント:使用してくださいarray_replace_recursive()後方の配列の値を使用して、最初の配列の値を再帰的に置き換えるには


構文

array_replace(array1,array2,array3...)

パラメータ 説明
array1 必須。配列を指定します。
array2 省略可能。置き換えるarray1値の配列を指定します。
array3,... 省略可能。複数の置き換えるarray1とarray2, ...値の配列を指定します。後方の配列の値は前方の配列の値を上書きします。

技術詳細

戻り値: 置き換えられた配列を返します。エラーが発生した場合は NULL を返します。
PHP バージョン: 5.3.0+


その他の例

例 1

キーが最初の配列 array1 と2番目の配列 array2 の両方に存在する場合、最初の配列 array1 の値は2番目の配列 array2 の値で置き換えられます。キーが最初の配列 array1 にのみ存在する場合は、そのまま保持されます。

<?php
$a1=array("a"=>"red","b"=>"green");
$a2=array("a"=>"orange","burgundy");
print_r(array_replace($a1,$a2));
?>

例を実行 »

例 2

キーが2番目の配列 array2 に存在するが、最初の配列 array1 には存在しない場合、その要素は最初の配列 array1 に作成されます。

<?php
$a1=array("a"=>"red","green");
$a2=array("a"=>"orange","b"=>"burgundy");
print_r(array_replace($a1,$a2));
?>

例を実行 »

例 3

3つの配列を使用 - 最後の配列($a3)が前の配列($a1 と $a2)を上書きします:

<?php
$a1=array("red","green");
$a2=array("blue","yellow");
$a3=array("orange","burgundy");
print_r(array_replace($a1,$a2,$a3));
?>

例を実行 »

例 4

数値キーを使用 - キーが2番目の配列 array2 に存在するが、最初の配列 array1 には存在しない場合、その要素は最初の配列 array1 に作成されます:

<?php
$a1=array("red","green","blue","yellow");
$a2=array(0=>"orange",3=>"burgundy");
print_r(array_replace($a1,$a2));
?>

例を実行 »


PHP Array 参考手册完全な PHP Array リファレンスマニュアル その他の拡張