哈希空间 Ctrl + F 进行搜索
首页 php手册中文版 CSS中文手册 哈希文档 Markdown在线工具

PHP array 组件

array_walk

(PHP 4, PHP 5, PHP 7, PHP 8)

array_walk使用用户自定义函数对数组中的每个元素做回调处理

说明

array_walk(array|object &$array, callable $callback, mixed $arg = null): bool

将用户自定义函数 callback 应用到 array 数组中的每个单元。

array_walk() 不会受到 array 内部数组指针的影响。array_walk() 会遍历整个数组而不管指针的位置。

参数

array

输入的数组。

callback

典型情况下 callback 接受两个参数。array 参数的值作为第一个,键名作为第二个。

注意:

如果 callback 需要直接作用于数组中的值,则给 callback 的第一个参数指定为引用。这样任何对这些单元的改变也将会改变原始数组本身。

注意:

参数数量超过预期,传入内置函数 (例如 strtolower()), 将抛出警告,所以不适合当做 callback

只有 array 的值才可以被改变,用户不应在回调函数中改变该数组本身的结构。例如增加/删除单元,unset 单元等等。如果 array_walk() 作用的数组改变了,则此函数的的行为未经定义,且不可预期。

arg

如果提供了可选参数 arg,将被作为第三个参数传递给 callback

返回值

返回 true

错误/异常

从 PHP 7.1.0 起,如果 callback 函数需要的参数(数组成员的值和键)超过2个或者 也传递了 arg 参数需要的参数超过3个时,会抛出 ArgumentCountError。 在此之前,每次 array_walk() 调用 callback 的时候都会生成 E_WARNING 级别的错误。

更新日志

版本 说明
8.0.0 如果 callback 期待通过引用传递第二个和第三个参数, 此函数现在将抛出 E_WARNING

范例

示例 #1 array_walk() 例子

<?php
$fruits 
= array("d" => "lemon""a" => "orange""b" => "banana""c" => "apple");

function 
test_alter(&$item1$key$prefix)
{
    
$item1 "$prefix$item1";
}

function 
test_print($item2$key)
{
    echo 
"$key$item2\n";
}

echo 
"Before ...:\n";
array_walk($fruits'test_print');

array_walk($fruits'test_alter''fruit');
echo 
"... and after:\n";

array_walk($fruits'test_print');
?>

以上例程会输出:

Before ...:
d. lemon
a. orange
b. banana
c. apple
... and after:
d. fruit: lemon
a. fruit: orange
b. fruit: banana
c. fruit: apple

示例 #2 array_walk() example using anonymous function

<?php
$elements 
= ['a''b''c'];
array_walk($elements, function ($value$key) {
  echo 
"{$key} => {$value}\n";
});
?>

以上例程会输出:

0 => a
1 => b
2 => c

参见

打开 哈希空间 微信小程序中查看更佳