array_walk
(PHP 3 >= 3.0.3, PHP 4, PHP 5)
array_walk --
对数组中的每个成员应用用户函数
说明
bool
array_walk ( array array, callback function [, mixed userdata] )
如果成功则返回 TRUE,失败则返回 FALSE。
将用户自定义函数 function 应用到
array 数组中的每个单元。典型情况下
function 接受两个参数。array
参数的值作为第一个,键名作为第二个。如果提供了可选参数
userdata,将被作为第三个参数传递给
callback function。
如果 function 函数需要的参数比给出的多,则每次
array_walk() 调用 function
时都会产生一个 E_WARNING
级的错误。这些警告可以通过在 array_walk() 调用前加上
PHP 的错误操作符 @
来抑制,或者用 error_reporting()。
注:
如果 function 需要直接作用于数组中的值,则给
function 的第一个参数指定为
reference。这样任何对这些单元的改变也将会改变原始数组本身。
注:
将键名和 userdata 传递到 func 中是 PHP 4.0 新增加的。
array_walk() 不会受到 array
内部数组指针的影响。array_walk()
会遍历整个数组而不管指针的位置。要重置指针,用 reset()。在
PHP 3 中,array_walk() 会重置指针。
用户不应在回调函数中改变该数组本身。例如增加/删除单元,unset
单元等等。如果 array_walk()
作用的数组改变了,则此函数的的行为未经定义,且不可预期。
例子 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
|
|
参见 list(),foreach,each()
和 call_user_func_array()。