array_map

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

array_map — 将回调应用于给定数组的元素

描述

array_map(?callable $callback, array $array, array ...$arrays): array

array_map() 返回一个 array，其中包含将 callback 应用于 array（如果提供了更多数组，则为 arrays）的相应值的返回值。 callback 函数接受的参数数量应与传递给 array_map() 的数组数量匹配。多余的输入数组将被忽略。如果提供的参数数量不足，则会抛出 ArgumentCountError 异常。

参数

callback

一个 callable，用于对每个数组中的每个元素执行操作。

null 可以作为值传递给 callback，以对多个数组执行 zip 操作，并返回一个数组，其元素是每个包含输入数组中相同索引的元素的数组（参见下面的示例）。如果只提供 array，array_map() 将返回输入数组。

array

要运行 callback 函数的数组。

arrays

要运行 callback 函数的补充可变数组参数列表。

返回值

返回一个数组，其中包含将 callback 函数应用于 array（如果提供了更多数组，则为 arrays）的相应值的返回值。

仅当且仅当传递了一个数组时，返回的数组才会保留数组参数的键。如果传递了多个数组，则返回的数组将具有连续的整数键。

变更日志

版本	描述
8.0.0	如果 `callback` 期望通过引用传递参数，则此函数现在将发出 `E_WARNING`。

示例

示例 #1 array_map() 示例

<?php
function cube($n)
{
 return ($n * $n * $n);
}

$a = [1, 2, 3, 4, 5];
$b = array_map('cube', $a);
print_r($b);
?>

这使得 $b 包含

Array
(
    [0] => 1
    [1] => 8
    [2] => 27
    [3] => 64
    [4] => 125
)

示例 #2 使用 lambda 函数的 array_map()

<?php
$func = function(int $value): int {
 return $value * 2;
};

print_r(array_map($func, range(1, 5)));

// PHP 7.4.0 及以后版本：

print_r(array_map(fn($value): int => $value * 2, range(1, 5)));

?>

Array
(
    [0] => 2
    [1] => 4
    [2] => 6
    [3] => 8
    [4] => 10
)

示例 #3 array_map() - 使用多个数组

<?php
function show_Spanish(int $n, string $m): string
{
 return "数字 {$n} 西班牙语是 {$m}";
}

function map_Spanish(int $n, string $m): array
{
 return [$n => $m];
}

$a = [1, 2, 3, 4, 5];
$b = ['uno', 'dos', 'tres', 'cuatro', 'cinco'];

$c = array_map('show_Spanish', $a, $b);
print_r($c);

$d = array_map('map_Spanish', $a , $b);
print_r($d);
?>

以上示例将输出

// printout of $c
Array
(
    [0] => The number 1 is called uno in Spanish
    [1] => The number 2 is called dos in Spanish
    [2] => The number 3 is called tres in Spanish
    [3] => The number 4 is called cuatro in Spanish
    [4] => The number 5 is called cinco in Spanish
)

// printout of $d
Array
(
    [0] => Array
        (
            [1] => uno
        )

    [1] => Array
        (
            [2] => dos
        )

    [2] => Array
        (
            [3] => tres
        )

    [3] => Array
        (
            [4] => cuatro
        )

    [4] => Array
        (
            [5] => cinco
        )

)

通常，当使用两个或多个数组时，它们应该具有相同的长度，因为回调函数并行地应用于相应的元素。如果数组长度不相等，较短的数组将用空元素扩展以匹配最长数组的长度。

此函数的一个有趣用法是构造一个数组的数组，这可以通过使用**null**作为回调函数的名称来轻松实现。

示例 #4 执行数组的 zip 操作

<?php
$a = [1, 2, 3, 4, 5];
$b = ['one', 'two', 'three', 'four', 'five'];
$c = ['uno', 'dos', 'tres', 'cuatro', 'cinco'];

$d = array_map(null, $a, $b, $c);
print_r($d);
?>

以上示例将输出

Array
(
    [0] => Array
        (
            [0] => 1
            [1] => one
            [2] => uno
        )

    [1] => Array
        (
            [0] => 2
            [1] => two
            [2] => dos
        )

    [2] => Array
        (
            [0] => 3
            [1] => three
            [2] => tres
        )

    [3] => Array
        (
            [0] => 4
            [1] => four
            [2] => cuatro
        )

    [4] => Array
        (
            [0] => 5
            [1] => five
            [2] => cinco
        )

)

示例 #5 **null** 回调函数 仅带 数组

<?php
$array = [1, 2, 3];
var_dump(array_map(null, $array));
?>

以上示例将输出

array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  int(3)
}

示例 #6 array_map() - 带字符串键

<?php
$arr = ['stringkey' => 'value'];
function cb1($a) {
 return [$a];
}
function cb2($a, $b) {
 return [$a, $b];
}
var_dump(array_map('cb1', $arr));
var_dump(array_map('cb2', $arr, $arr));
var_dump(array_map(null, $arr));
var_dump(array_map(null, $arr, $arr));
?>

以上示例将输出

array(1) {
  ["stringkey"]=>
  array(1) {
    [0]=>
    string(5) "value"
  }
}
array(1) {
  [0]=>
  array(2) {
    [0]=>
    string(5) "value"
    [1]=>
    string(5) "value"
  }
}
array(1) {
  ["stringkey"]=>
  string(5) "value"
}
array(1) {
  [0]=>
  array(2) {
    [0]=>
    string(5) "value"
    [1]=>
    string(5) "value"
  }
}

示例 #7 array_map() - 关联数组

array_map() 不直接支持使用数组键作为输入，但这可以使用array_keys() 来模拟。

<?php
$arr = [
 'v1' => 'First release',
 'v2' => 'Second release',
 'v3' => 'Third release',
];

// 注意：在 7.4.0 之前，请使用较长的匿名函数语法。
$callback = fn(string $k, string $v): string => "$k 是 $v";

$result = array_map($callback, array_keys($arr), array_values($arr));

var_dump($result);
?>

以上示例将输出

array(3) {
  [0]=>
  string(24) "v1 was the First release"
  [1]=>
  string(25) "v2 was the Second release"
  [2]=>
  string(24) "v3 was the Third release"
}

另见

array_filter() - 使用回调函数过滤数组的元素
array_reduce() - 使用回调函数迭代地将数组简化为单个值
array_walk() - 将用户提供的函数应用于数组的每个成员

发现问题？

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 8 条注释

上

下

lukasz dot mordawski at gmail dot com ¶

11 年前

让我们假设我们有以下情况

<?php
class MyFilterClass {
 public function filter(array $arr) {
 return array_map(function($value) {
 return $this->privateFilterMethod($value);
 });
 }

 private function privateFilterMethod($value) {
 if (is_numeric($value)) $value++;
 else $value .= '.';
 }
}
?>

这将有效，因为匿名函数内的 $this（与例如 javascript 不同）是调用它的 MyFilterClass 的实例。
我希望这对任何人都能有所帮助。

上

下

[email protected] ¶

16年前

要转置矩形二维数组，请使用以下代码：

array_unshift($array, null);
$array = call_user_func_array("array_map", $array);

如果需要将矩形二维数组旋转90度，请在上述代码之前或之后（取决于所需的旋转方向）添加以下代码：
$array = array_reverse($array);

这是一个例子：

<?php
$a = array(
 array(1, 2, 3),
 array(4, 5, 6));
array_unshift($a, null);
$a = call_user_func_array("array_map", $a);
print_r($a);
?>

输出

数组
(
[0] => 数组
        (
            [0] => 1
            [1] => 4
        )

[1] => 数组
        (
            [0] => 2
            [1] => 5
        )

[2] => 数组
        (
            [0] => 3
            [1] => 6
        )

)

上

下

Mahn ¶

9年前

您可能正在寻找一种根据条件提取多维数组值的方法（即 array_map 和 array_filter 的混合），而不是 for/foreach 循环。如果是这样，您可以利用以下事实：1) 如果没有指定显式返回值，array_map 上的回调方法将返回 null（与其他所有内容一样）；2) 没有参数的 array_filter 将删除虚假值。

例如，假设您有：

<?php
$data = [
 [
 "name" => "John",
 "smoker" => false
 ],
 [
 "name" => "Mary",
 "smoker" => true
 ],
 [
 "name" => "Peter",
 "smoker" => false
 ],
 [
 "name" => "Tony",
 "smoker" => true
 ]
];
?>

您可以使用以下单行代码提取所有非吸烟者的姓名：

<?php
$names = array_filter(array_map(function($n) { if(!$n['smoker']) return $n['name']; }, $data));
?>

它不一定比 for/foreach 循环更好，但对于简单的任务，偶尔使用单行代码可以使您的代码更简洁。

上

下

[email protected] ¶

1年前

如果要调用的回调函数是来自不同命名空间的静态方法，则必须指定包含命名空间的完全限定方法名（use 语句不足以解析回调函数的命名空间）。

<?php
use MyTools;

$arr = [1, 2, 3];

$arr = array_map('Tools::myHelper', $arr);
?>

将导致 TypeError
array_map() 期望参数 1 为有效的回调函数，找不到类“Tools”。

改用回调函数的完全限定名称：

<?php
$arr = [1, 2, 3];

$arr = array_map('\MyTools\Tools::myHelper', $arr);
?>

上

下

CertaiN ¶

11 年前

最节省内存的 array_map_recursive()。

<?php
function array_map_recursive(callable $func, array $arr) {
 array_walk_recursive($arr, function(&$v) use ($func) {
 $v = $func($v);
 });
 return $arr;
}
?>

上

下

[email protected] ¶

16年前

如果要将参数（如 ENT_QUOTES）传递给 htmlentities，可以执行以下操作。

<?php
$array = array_map( 'htmlentities' , $array, array_fill(0 , count($array) , ENT_QUOTES) );
?>

第三个参数创建一个与 $array 大小相同的数组，其中填充了您希望与回调函数一起使用的参数。

上

下

Walf ¶

2年前

一个通用的解决方案，用于解决想要在回调中知道键，和/或在返回的数组中保留键关联的问题。

<?php

/**
 * 与 array_map() 类似，但回调函数也会将当前键作为第一个参数传递，如下所示：
 * function($key, $val, ...$vals) { ... }
 * ...返回的数组始终保持键关联，即使传递多个
 * 数组参数。
 */

function array_map_assoc(callable $callback, array $array, array ...$arrays) {
 $keys = array_keys($array);
 array_unshift($arrays, $keys, $array);
 return array_combine($keys, array_map($callback, ...$arrays));
}

?>

因为它直接使用 array_map()，所以在忽略后续数组参数的键方面，它的行为方式相同。它也具有相同的可变参数签名。

上

下

anonymous_user ¶

2年前

/** 
* 递归地将回调应用于所有值及其
* 键的函数，并返回具有更新键和
* 值的结果数组副本。
* PHP 的内置函数 array_walk_recursive() 只将传递的
* 回调应用于数组值，而不是键，因此此函数只是
* 也将回调应用于键（因此需要使用副本，
* 因为更新键也会导致原始
* 数组的引用丢失）。我需要这样的东西，因此我想在这里分享它。
  *
* @param callable $func 回调函数，它接受一个参数（要更新的值
* 或键）并返回其
* 更新后的值
  *
* @param array $arr 将更新其键和值的数组
*
  */

function array_map_recursive(
callable $func,
array $arr
) {

// 初始化将保存所有更新的键 + 值的复制数组
$result = [];

// 迭代数组的键值对
foreach ( $arr as $key => $value ) {

// 将回调应用于键以创建更新的键值
$updated_key = $func( $key );

// 如果迭代的值不是数组，则表示已达到
// 迭代键的最深数组级别，因此在这种情况下，将
// 更新的值分配给最终输出数组中更新的键值
if ( ! is_array( $value ) ) {

$result[$updated_key] = $func( $value );

} else {

// 如果迭代的值是数组，则递归调用函数，
// 通过将当前迭代的值作为 $arr 参数
$result[$updated_key] = array_map_recursive(
$func,
$arr[$key]
          );

        }

} // 键值对迭代结束

// 最后，返回生成的 result set
return $result;

} // array_map_recursive() 函数定义结束

＋添加注释