wp_list_filter( array $list, array $args = array(), string $operator = 'AND' )

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

Description Description

Parameters Parameters


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


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

Default value: array()


(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 value: 'AND'

Top ↑

Return Return

(array) Array of found values.

Top ↑

Source Source

File: wp-includes/functions.php

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

Top ↑

Changelog Changelog

Version Description
4.7.0 Uses WP_List_Util class.
3.1.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.