PHP array_replace() 函数

PHP Array 参考手册

示例

使用第二个数组（$a2）的值替换第一个数组（$a1）的值：

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

执行结果

Array ( [0] => blue [1] => yellow )

定义和用法

array_replace() 函数使用后面数组的值替换第一个数组的值。

提示：您可以向函数传递一个数组，或者多个数组。

如果一个键存在于第一个数组 array1 同时也存在于第二个数组 array2，第一个数组 array1 中的值将被第二个数组 array2 中的值替换。如果一个键仅存在于第一个数组 array1，它将保持不变。（详见下面的实例 1）

如果一个键存在于第二个数组 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 同时也存在于第二个数组 array2，第一个数组 array1 中的值将被第二个数组 array2 中的值替换。如果一个键仅存在于第一个数组 array1，它将保持不变。

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

执行结果

Array ( [a] => orange [b] => green [0] => burgundy )

#2 如果一个键存在于第二个数组 array2，但是不存在于第一个数组 array1，则会在第一个数组 array1 中创建这个元素。

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

执行结果

Array ( [a] => orange [0] => green [b] => burgundy )

#3 使用三个数组 - 最后一个数组（$a3）将覆盖之前数组（$a1 和 $a2）：

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

执行结果

Array ( [0] => orange [1] => burgundy )

#4 使用数值键 - 如果一个键存在于第二个数组 array2，但是不存在于第一个数组 array1，则会在第一个数组 array1 中创建这个元素：

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

执行结果

Array ( [0] => orange [1] => green [2] => blue [3] => burgundy )

PHP Array 参考手册