array_walk

说明

bool array_walk ( array array, callback function [, mixed userdata])

如果成功则返回TRUE，失败则返回FALSE。

将用户自定义函数function应用到array数组中的每个单元。典型情况下function接受两个参数。array参数的值作为第一个，键名作为第二个。如果提供了可选参数userdata，将被作为第三个参数传递给 callbackfunction。

如果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() 作用的数组改变了，则此函数的的行为未经定义，且不可预期。 

<?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