array_replace_recursive
渡された配列の要素を再帰的に置き換える
&reftitle.description;
arrayarray_replace_recursive
arrayarray
arrayreplacements
array_replace_recursive は、
array の値をそれ以降の配列の同じ要素の値で置き換えます。
最初の配列のキーと同じキーが 2 番目の配列にあれば、
2 番目の配列の値が最初の配列の値を上書きします。
2 番目の配列に存在するキーが最初の配列に存在しなければ、
そのキーが新たに最初の配列内に作られます。
最初の配列にしか存在しないキーについては何も変わりません。
置き換え用の配列が複数渡された場合は渡した順に処理を行い、
後から渡した配列の値のほうが優先されます。
array_replace_recursive は再帰的な処理を行います。
配列を再帰的にたどり、内部の値に対しても同じ手順で処理します。
最初の配列の値がスカラーの場合は、
2 番目の配列の値がスカラーであるか配列であるかにかかわらずそれで置き換えられます。
最初の配列の値と 2番目の配列
の値が両方配列である場合は、array_replace_recursive
が対応する値を再帰的に処理します。
&reftitle.parameters;
array
要素を置き換えたい配列。
replacements
置き換えたい要素を含む配列。
&reftitle.returnvalues;
配列を返します。
&reftitle.examples;
<function>array_replace_recursive</function> の例
array( "orange") , 'berries' => array("blackberry", "raspberry"), );
$replacements = array('citrus' => array('pineapple'), 'berries' => array('blueberry'));
$basket = array_replace_recursive($base, $replacements);
print_r($basket);
$basket = array_replace($base, $replacements);
print_r($basket);
?>
]]>
&example.outputs;
Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
[1] => raspberry
)
)
Array
(
[citrus] => Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
)
)
]]>
<function>array_replace_recursive</function> での再帰的な挙動の例
array("orange") , 'berries' => array("blackberry", "raspberry"), 'others' => 'banana' );
$replacements = array('citrus' => 'pineapple', 'berries' => array('blueberry'), 'others' => array('litchis'));
$replacements2 = array('citrus' => array('pineapple'), 'berries' => array('blueberry'), 'others' => 'litchis');
$basket = array_replace_recursive($base, $replacements, $replacements2);
print_r($basket);
?>
]]>
&example.outputs;
Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
[1] => raspberry
)
[others] => litchis
)
]]>
&reftitle.seealso;
array_replace
array_merge_recursive