根据一组key => value参数过滤对象列表。

原型

wp_list_filter( array $list, array $args = array(), string $operator = 'AND' )

参数

$list (array) (Required) 要过滤的对象数组。

$args (array) (Optional)  用于匹配每个对象的key => value参数数组。

$operator (string) (Optional)  要执行的逻辑操作。 ‘AND’表示数组中的所有元素必须匹配。 ‘OR’表示只需要匹配一个元素。 ‘NOT’表示没有元素可以匹配。

返回值

(array)  找到的值的数组。

源文件

路径:wp-includes/functions.php

<?php
...
function wp_list_filter( $list, $args = array(), $operator = 'AND' ) {
	if ( ! is_array( $list ) ) {
		return array();
	}
	$util = new WP_List_Util( $list );
	return $util->filter( $args, $operator );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_list_filter/