wp_list_filter( array $list, array $args = array(), string $operator = 'AND' )
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. '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'
Return
(array) Array of found values.
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 );
}
Changelog
| Version | Description |
|---|---|
| WP-4.7.0 | Uses WP_List_Util class. |
| WP-3.1.0 | Introduced. |