PHP array_replace() 函数

PHP array_replace() 函数

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

实例

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

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


定义和用法

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,... 可选。指定多个要替换 array1array2, ... 的值的数组。后面数组的值将覆盖之前数组的值。

技术细节

返回值: 返回被替换的数组,如果发生错误则返回 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));
?>


实例 2

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

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


实例 3

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

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


实例 4

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

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



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