Php/docs/function.array-filter

• PHP Manual
• 数组 函数
• 用回调函数过滤数组中的单元

array_filter

(PHP 4 >= 4.0.6, PHP 5, PHP 7)

array_filter — 用回调函数过滤数组中的单元

说明

array_filter ( array $array [, callable $callback [, int $flag = 0 ]] ) : array

依次将 array 数组中的每个值传递到 callback 函数。如果 callback 函数返回 true，则 array 数组的当前值会被包含在返回的结果数组中。数组的键名保留不变。

参数

array

要循环的数组

callback

使用的回调函数

如果没有提供 callback 函数， 将删除 array 中所有等值为 false 的条目。更多信息见转换为布尔值。

flag

决定callback接收的参数形式:

• ARRAY_FILTER_USE_KEY - callback接受键名作为的唯一参数
• ARRAY_FILTER_USE_BOTH - callback同时接受键名和键值

返回值

返回过滤后的数组。

更新日志

版本	说明
5.6.0	添加可选的参数 flag，以及常量 ARRAY_FILTER_USE_KEY 和 ARRAY_FILTER_USE_BOTH。

范例

Example #1 array_filter() 例子

<?phpfunction odd($var){    // returns whether the input integer is odd    return($var & 1);}function even($var){    // returns whether the input integer is even    return(!($var & 1));}$array1 = array("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5);$array2 = array(6, 7, 8, 9, 10, 11, 12);echo "Odd :\n";print_r(array_filter($array1, "odd"));echo "Even:\n";print_r(array_filter($array2, "even"));?>

以上例程会输出：

Odd :
Array
(
    [a] => 1
    [c] => 3
    [e] => 5
)
Even:
Array
(
    [0] => 6
    [2] => 8
    [4] => 10
    [6] => 12
)

Example #2 不使用 callback 时的array_filter()

<?php$entry = array(             0 => 'foo',             1 => false,             2 => -1,             3 => null,             4 =>           );print_r(array_filter($entry));?>

以上例程会输出：

Array
(
    [0] => foo
    [2] => -1
)

Example #3 带 flag 标记的 array_filter()

<?php$arr = ['a' => 1, 'b' => 2, 'c' => 3, 'd' => 4];var_dump(array_filter($arr, function($k) {    return $k == 'b';}, ARRAY_FILTER_USE_KEY));var_dump(array_filter($arr, function($v, $k) {    return $k == 'b' || $v == 4;}, ARRAY_FILTER_USE_BOTH));?>

以上例程会输出：

array(1) {
  ["b"]=>
  int(2)
}
array(2) {
  ["b"]=>
  int(2)
  ["d"]=>
  int(4)
}

注释

Caution 用户不应在回调函数中修改数组本身。例如增加／删除单元或者对 array_filter() 正在作用的数组进行 unset。如果数组改变了，此函数的行为将不可预测。

参见

• array_map() - 为数组的每个元素应用回调函数
• array_reduce() - 用回调函数迭代地将数组简化为单一的值
• array_walk() - 使用用户自定义函数对数组中的每个元素做回调处理