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

原型

wp_filter_object_list( array $list, array $args = array(), string $operator = 'and', bool|string $field = false )

参数

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

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

$operator (string) (Optional)  要执行的逻辑操作。 ‘或’表示只需要匹配数组中的一个元素; ‘和’表示所有元素必须匹配; ‘not’表示没有元素匹配。

$field (bool|string) (Optional) 从对象到位置而不是整个对象的字段。

返回值

(array)  对象或对象字段的列表。

源文件

路径:wp-includes/functions.php

<?php
...
function wp_filter_object_list( $list, $args = array(), $operator = 'and', $field = false ) {
	if ( ! is_array( $list ) ) {
		return array();
	}
	$util = new WP_List_Util( $list );
	$util->filter( $args, $operator );
	if ( $field ) {
		$util->pluck( $field );
	}
	return $util->get_output();
}
...
?>

其他

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