array_replace_recursive
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
array_replace_recursive — 使用傳遞的陣列遞迴替換第一個陣列的元素
說明
array_replace_recursive(array
$array, array ...$replacements): array
array_replace_recursive() 使用後面陣列元素的值替換陣列 array 的值。
如果一個鍵存在於第一個陣列同時也存在於第二個陣列，它的值將被第二個陣列中的值替換。
如果一個鍵存在於第二個陣列，但是不存在於第一個陣列，則會在第一個陣列中建立這個元素。
如果一個鍵僅存在於第一個陣列，它將保持不變。
如果傳遞了多個替換陣列，它們將被按順序依次處理，後面的陣列將覆蓋之前的值。
array_replace_recursive() 是遞迴的：它將遍歷陣列並將相同的處理應用到陣列的內部值。
如果第一個陣列中的值是標量，它的值將被第二個陣列中的值替換，它可能是一個標量或者陣列。如果第一個陣列和第二個陣列中的值都是陣列， array_replace_recursive() 函式將遞迴地替換它們各自的值。
參數
-
array -
替換該陣列的值。
-
replacements -
包含要提取元素的陣列。
返回值
返回一個陣列。如果發生錯誤，將返回 null。
範例
示例 #1 array_replace_recursive() 範例
<?php
$base = array('citrus' => 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);
?>
以上例程會輸出：
Array
(
[citrus] => Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
[1] => raspberry
)
)
Array
(
[citrus] => Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
)
)
示例 #2 array_replace_recursive() 及其遞迴表現
<?php
$base = array('citrus' => 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);
?>
以上例程會輸出：
Array
(
[citrus] => Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
[1] => raspberry
)
[others] => litchis
)