array_walk

(PHP 4, PHP 5, PHP 7)

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

说明

array_walk ( array &$array , callable $callback [, mixed $userdata = NULL ] ) : bool

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

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

参数

array

输入的数组。

callback

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

Note:

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

Note:

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

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

userdata

如果提供了可选参数 userdata，将被作为第三个参数传递给 callback funcname。

返回值

成功时返回 TRUE， 或者在失败时返回 FALSE。

错误／异常

如果 callback 函数需要的参数比给出的多，则每次 array_walk() 调用 callback 时都会产生一个 E_WARNING 级的错误。

范例

Example #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<br />\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

参见

相关文章
php 数组 函数 将数组中的所有键名修改为全大写或小写php 数组 函数 交换数组中的键和值php 数组 函数 为数组的每个元素应用回调函数php 数组 函数 使用传递的数组递归替换第一个数组的元素php 数组 函数 使用传递的数组替换第一个数组的元素php 数组 函数 对数组中的每个成员递归地应用用户函数php 数组 函数 使用用户自定义函数对数组中的每个元素做回调处理php 类/对象 函数 以参数列表的数组，调用用户方法php 数组 函数 返回数组中的当前单元php spl 函数 为迭代器中每个元素调用一个用户自定义函数php spl 函数 将迭代器中的元素拷贝到数组php 数组 函数 把数组中的值赋给一组变量php 数组 函数 将数组中的内部指针向前移动一位php 数组 函数 根据范围创建数组，包含指定的元素php session 函数 设置用户自定义会话存储函数php 错误处理 函数 设置用户自定义的错误处理函数php 数组 函数 使用用户自定义的比较函数对数组中的值进行排序并保持索引关联php 数组 函数 使用用户自定义的比较函数对数组中的键名进行排序php 数组 函数 使用用户自定义的比较函数对数组中的值进行排序php 函数 用户自定义函数
关注编程学问公众号