Php/docs/function.array-walk
array_walk
(PHP 4, PHP 5, PHP 7)
array_walk — 使用用户自定义函数对数组中的每个元素做回调处理
说明
将用户自定义函数 funcname
应用到
array
数组中的每个单元。
array_walk() 不会受到 array
内部数组指针的影响。array_walk()
会遍历整个数组而不管指针的位置。
参数
array
输入的数组。
callback
典型情况下
callback
接受两个参数。array
参数的值作为第一个,键名作为第二个。Note:
如果
callback
需要直接作用于数组中的值,则给callback
的第一个参数指定为引用。这样任何对这些单元的改变也将会改变原始数组本身。Note:
参数数量超过预期,传入内置函数 (例如 strtolower()), 将抛出警告,所以不适合当做
funcname
。只有
array
的值才可以被改变,用户不应在回调函数中改变该数组本身的结构。例如增加/删除单元,unset 单元等等。如果 array_walk() 作用的数组改变了,则此函数的的行为未经定义,且不可预期。userdata
如果提供了可选参数
userdata
,将被作为第三个参数传递给 callbackfuncname
。
返回值
成功时返回 true
, 或者在失败时返回 false
。
范例
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() - 为迭代器中每个元素调用一个用户自定义函数
- list() - 把数组中的值赋给一组变量
- each() - 返回数组中当前的键/值对并将数组指针向前移动一步
- call_user_func_array() - 调用回调函数,并把一个数组参数作为回调函数的参数
- array_map() - 为数组的每个元素应用回调函数
- foreach