1. php文档
  2. array_replace()

PHP array_replace() 函数

PHP Array 参考手册完整的 PHP Array 参考手册

实例

使用第二个数组($a2)的值替换第一个数组($a1)的值:

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

[运行实例 »](/try/showphp.php?filename=demo_func_array_replace)

定义和用法

array_replace() 函数使用后面数组的值替换第一个数组的值。 **提示:**您可以向函数传递一个数组,或者多个数组。 如果一个键存在于第一个数组 array1 同时也存在于第二个数组 array2,第一个数组 array1 中的值将被第二个数组 array2 中的值替换。如果一个键仅存在于第一个数组 array1,它将保持不变。(详见下面的实例 1) 如果一个键存在于第二个数组 array2,但是不存在于第一个数组 array1,则会在第一个数组 array1 中创建这个元素。(详见下面的实例 2) 如果传递了多个替换数组,它们将被按顺序依次处理,后面数组的值将覆盖之前数组的值。(详见下面的实例 3) **提示:**请使用 [array_replace_recursive()](func-array-replace-recursive.html) 来递归地使用后面数组的值替换第一个数组的值。

语法

array_replace(array1,array2,array3...)

参数 描述
array1 必需。指定一个数组。
array2 可选。指定一个要替换 array1 的值的数组。
array3,... 可选。指定多个要替换 array1array2, ... 的值的数组。后面数组的值将覆盖之前数组的值。

技术细节

返回值: 返回被替换的数组,如果发生错误则返回 NULL。
PHP 版本: 5.3.0+

更多实例

实例 1

如果一个键存在于第一个数组 array1 同时也存在于第二个数组 array2,第一个数组 array1 中的值将被第二个数组 array2 中的值替换。如果一个键仅存在于第一个数组 array1,它将保持不变。

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

运行实例 »

实例 2

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

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

运行实例 »

实例 3

使用三个数组 - 最后一个数组($a3)将覆盖之前数组($a1 和 $a2):

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

运行实例 »

实例 4

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

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

运行实例 »


PHP Array 参考手册完整的 PHP Array 参考手册