大网数据广告活动
PHP 语言与运行手册

array_replace · 使用传递的数组替换第一个数组的元素

· 52CE 我爱测

array_replace() 创建新数组,并为提供的数组中的每个 key 都分配元素。如果某个 key 出现在多个输入数组中,则将使用最右侧输入数组中的值。

array_replace

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

array_replace — 使用传递的数组替换第一个数组的元素

说明

function array_replace(array $array, array ...$replacements): array

array_replace() 创建新数组,并为提供的数组中的每个 key 都分配元素。如果某个 key 出现在多个输入数组中,则将使用最右侧输入数组中的值。

array_replace() 不会递归处理元素项,它在替换时会替换每个 key 的值。

参数

array

替换该数组的值。

replacements

包含要提取元素的数组。 后面的数组里的值会覆盖前面的值。

返回值

返回 array。

示例

示例 #1 array_replace() 示例

<?php
$base = array("orange", "banana", "apple", "raspberry");
$replacements = array(0 => "pineapple", 4 => "cherry");
$replacements2 = array(0 => "grape");

$basket = array_replace($base, $replacements, $replacements2);
var_dump($basket);
?>

以上示例会输出:

array(5) {
  [0]=>
  string(5) "grape"
  [1]=>
  string(6) "banana"
  [2]=>
  string(5) "apple"
  [3]=>
  string(9) "raspberry"
  [4]=>
  string(6) "cherry"
}

示例 #2 嵌套数组的处理方式示例

<?php
$base = [ 'citrus' => [ 'orange', 'lemon' ], 'pome' => [ 'apple' ] ];
$replacements = [ 'citrus' => [ 'grapefruit' ] ];
$replacements2 = [ 'citrus' => [ 'kumquat', 'citron' ], 'pome' => [ 'loquat' ] ];

$basket = array_replace($base, $replacements, $replacements2);
var_dump($basket);
?>

以上示例会输出:

array(2) {
  ["citrus"]=>
  array(2) {
    [0]=>
    string(7) "kumquat"
    [1]=>
    string(6) "citron"
  }
  ["pome"]=>
  array(1) {
    [0]=>
    string(6) "loquat"
  }
}

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。