array_filter
(PHP 4 >= 4.0.6, PHP 5, PHP 7)
array_filter — 用回调函数过滤数组中的单元
说明
依次将 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() 例子
<?php
function 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() - 使用用户自定义函数对数组中的每个元素做回调处理