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 "The number {$n} is called {$m} in Spanish";
}

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 was the $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 ¶

10 年前

假设我们有以下情况

<?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 实例。
我希望这对任何人都能有所帮助。

向上

向下

radist-hack at yandex dot ru ¶

15 年前

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

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 ¶

8 年前

您可能正在寻找一种方法来根据条件提取多维数组的值（即 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 循环更好，但对于琐碎的任务，偶尔使用单行代码可以帮助保持代码更简洁。

向上

向下

s dot kientzler at online dot de ¶

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 ¶

10 年前

最节省内存的 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;
}
?>

向上

向下

stijnleenknegt at gmail dot com ¶

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]
          );

        }

} // 结束遍历 k-v 对

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

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

＋添加笔记