PHPのarray_replace()関数

例

最初の配列 ($a1) の値を 2 番目の配列 ($a2) の値に置き換えます。

<?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(配列1,配列2,配列3... )

パラメータ	説明する
配列1	必須。配列を指定します。
配列2	オプション。 array1の値を置き換える配列を指定します。
配列3、...	オプション。複数の配列を指定して、 array1 、 array2、...の値を置き換えます。次の配列の値は、前の配列の値を上書きします。

技術的な詳細

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

他の例

例1

キーが最初の配列 array1 に存在し、2 番目の配列 array2 にも存在する場合、最初の配列 array1 の値は 2 番目の配列 array2 の値で置き換えられます。キーが最初の配列 array1 にのみ存在する場合、キーは変更されないままになります。

<?php$a1=array("a"=>"赤","b"=>"緑");$a2=array("a"=>"オレンジ","バーガンディ");print_r(array_replace( $a1,$a2));?>

例 2

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

<?php$a1=array("a"=>"赤","緑");$a2=array("a"=>"オレンジ","b"=>"バーガンディ");print_r(array_replace( $a1,$a2));?>

例 3

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

<?php$a1=array("赤","緑");$a2=array("青","黄");$a3=array("オレンジ","バーガンディ");print_r(array_replace($ a1,$a2,$a3));?>

例 4

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

<?php$a1=array("赤","緑","青","黄");$a2=array(0=>"オレンジ",3=>"バーガンディ");print_r(array_replace($ a1,$a2));?>