PHP array_walk 数组函数

  • 定义和用法

    array_walk - 使用用户自定义函数对数组中的每个元素做回调处理
  • 版本支持

    PHP4 PHP5 PHP7
    支持 支持 支持
  • 语法

    array_walk ( array &$array , callable $callback [, mixed $userdata = NULL ] )   
    
    将用户自定义函数 funcname 应用到 array 数组中的每个单元。 array_walk() 不会受到 array 内部数组指针的影响。array_walk() 会遍历整个数组而不管指针的位置。
  • 参数

    参数 必需的 描述
    array 输入的数组。
    callback 典型情况下 callback 接受两个参数。array 参数的值作为第一个,键名作为第二个。
    如果 callback 需要直接作用于数组中的值,则给 callback 的第一个参数指定为引用。这样任何对这些单元的改变也将会改变原始数组本身。
    参数数量超过预期,传入内置函数 (例如 strtolower()), 将抛出警告,所以不适合当做函数名。
    userdata 如果提供了可选参数 userdata,将被作为第三个参数传递给 callback。
  • 返回值

    成功时返回 TRUE, 或者在失败时返回 FALSE。
    如果 callback 函数需要的参数比给出的多,则每次 array_walk() 调用 callback 时都会产生一个 E_WARNING 级的错误。
  • 示例

    <?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 "之前 ...:<br/>";
    array_walk($fruits, 'test_print');
    
    array_walk($fruits, 'test_alter', 'fruit');
    echo "... 之后:<br/>";
    
    array_walk($fruits, 'test_print');
    ?>
    
    尝试一下
  • 相关函数

    array_walk_recursive() - 对数组中的每个成员递归地应用用户函数
    array_map() - 为数组的每个元素应用回调函数