wp_filter_object_list

函数


wp_filter_object_list ( $list, $args = array(), $operator = 'and', $field = false )
参数
  • (array)
    $list
    An array of objects to filter.
    Required: 是
  • (array)
    $args
    Optional. An array of key => value arguments to match against each object. Default empty array.
    Required: 否
    Default: array()
  • (string)
    $operator
    Optional. The logical operation to perform. ‘AND’ means all elements from the array must match. ‘OR’ means only one element needs to match. ‘NOT’ means no elements may match. Default ‘AND’.
    Required: 否
    Default: ‘and’
  • (bool|string)
    $field
    Optional. A field from the object to place instead of the entire object. Default false.
    Required: 否
    Default: false
返回值
  • (array) A list of objects or object fields.
定义位置
  • wp-includes/functions.php
    , line 5124
引入
3.0.0
弃用
–

Filters a list of objects, based on a set of key => value arguments.

Retrieves the objects from the list that match the given arguments.
Key represents property name, and value represents property value.

If an object has more properties than those specified in arguments,
that will not disqualify it. When using the ‘AND’ operator,
any missing properties will disqualify it.

When using the `$field` argument, this function can also retrieve
a particular field from all matching objects, whereas wp_list_filter()
only does the filtering.

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();
}
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。