W3cubDocs

/WordPress

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.

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. 'or' means only one element from the array needs to match; 'and' means all elements must match; 'not' means no elements may match.

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();
}

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–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_filter_object_list