array_walk
(PHP 4, PHP 5)
array_walk — 使用用户自定义函数对数组中的每个元素做回调处理
说明
bool array_walk ( array &$array , callable $funcname [, mixed $userdata = NULL ] )
将用户自定义函数 funcname 应用到 array 数组中的每个单元。
array_walk() 不会受到 array 内部数组指针的影响。array_walk() 会遍历整个数组而不管指针的位置。
参数
array
输入的数组。
funcname
典型情况下 funcname 接受两个参数。array 参数的值作为第一个，键名作为第二个。
Note:
如果 funcname 需要直接作用于数组中的值，则给 funcname 的第一个参数指定为引用。这样任何对这些单元的改变也将会改变原始数组本身。
Note:
Many internal functions (for example strtolower())
will throw a warning if more than the expected number of argument
are passed in and are not usable directly as funcname.
只有 array 的值才可以被改变，用户不应在回调函数中改变该数组本身的结构。例如增加/删除单元，unset
单元等等。如果 array_walk() 作用的数组改变了，则此函数的的行为未经定义，且不可预期。
userdata
如果提供了可选参数 userdata，将被作为第三个参数传递给
callback funcname。
返回值
成功时返回 TRUE， 或者在失败时返回 FALSE。
错误／异常
如果 funcname 函数需要的参数比给出的多，则每次 array_walk() 调用 funcname 时都会产生一个 E_WARNING
级的错误。这些警告可以通过在 array_walk() 调用前加上
PHP 的错误操作符 @
来抑制，或者用 error_reporting()。
范例
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
参见
array_walk_recursive() – 对数组中的每个成员递归地应用用户函数
iterator_apply() – 为迭代器中每个元素调用一个用户自定义函数
create_function() – Create an anonymous (lambda-style) function
list() – 把数组中的值赋给一些变量
each() – 返回数组中当前的键／值对并将数组指针向前移动一步
call_user_func_array() – 调用回调函数，并把一个数组参数作为回调函数的参数
array_map() – 将回调函数作用到给定数组的单元上
callback 类型的信息
foreach
