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

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

Description

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.

Parameters

$list

(array) (Required) An array of objects to filter.

$args

(array) (Optional) An array of key => value arguments to match against each object.

Default value: array()

$operator

(string) (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'.

Default value: 'and'

$field

(bool|string) (Optional) A field from the object to place instead of the entire object.

Default value: false

Return

(array) A list of objects or object fields.

Source

File: wp-includes/functions.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();
}

Uses

Uses	Description
wp-includes/class-wp-list-util.php: WP_List_Util::__construct()	Constructor.

Used By

Used By	Description
wp-includes/post.php: get_post_types_by_support()	Retrieves a list of post type names that support a specific feature.
wp-admin/includes/class-wp-plugin-install-list-table.php: WP_Plugin_Install_List_Table::prepare_items()
wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::get_columns()
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::get_columns()
wp-includes/taxonomy.php: get_taxonomies()	Retrieves a list of registered taxonomy names or objects.
wp-includes/post.php: get_post_stati()	Get a list of post statuses.
wp-includes/post.php: get_post_types()	Get a list of all registered post type objects.

Changelog

Version	Description
4.7.0	Uses `WP_List_Util` class.
3.0.0	Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_filter_object_list