WordPress at a glance

wp_list_filter() WP 1.0

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

Works based on: WP_List_Util()
1 time — 0.000001 sec (speed of light) | 50000 times — 0.09 sec (speed of light) | PHP 7.4.8, WP 5.6.2

No Hooks.


Array. Array of found values.


wp_list_filter( $list, $args, $operator );
$list(array) (required)
An array of objects to filter.
An array of key => value arguments to match against each object.
Default: empty array
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'


Since 3.1.0 Introduced.
Since 4.7.0 Uses WP_List_Util class.

Code of wp_list_filter() WP 5.7.1

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

From tag: array list help functions (sorting arrays objects)

More from category: Helper Functions

No comments
    Log In