diff -r be944660c56a -r 3d72ae0968f4 wp/wp-includes/class-wp-list-util.php --- a/wp/wp-includes/class-wp-list-util.php Wed Sep 21 18:19:35 2022 +0200 +++ b/wp/wp-includes/class-wp-list-util.php Tue Sep 27 16:37:53 2022 +0200 @@ -9,7 +9,7 @@ /** * List utility. * - * Utility class to handle operations on an array of objects. + * Utility class to handle operations on an array of objects or arrays. * * @since 4.7.0 */ @@ -34,7 +34,7 @@ * Temporary arguments for sorting. * * @since 4.7.0 - * @var array + * @var string[] */ private $orderby = array(); @@ -102,7 +102,8 @@ $operator = strtoupper( $operator ); if ( ! in_array( $operator, array( 'AND', 'OR', 'NOT' ), true ) ) { - return array(); + $this->output = array(); + return $this->output; } $count = count( $args ); @@ -139,15 +140,15 @@ } /** - * Plucks a certain field out of each object in the list. + * Plucks a certain field out of each element in the input array. * * This has the same functionality and prototype of * array_column() (PHP 5.5) but also supports objects. * * @since 4.7.0 * - * @param int|string $field Field from the object to place instead of the entire object - * @param int|string $index_key Optional. Field from the object to use as keys for the new array. + * @param int|string $field Field to fetch from the object or array. + * @param int|string $index_key Optional. Field from the element to use as keys for the new array. * Default null. * @return array Array of found values. If `$index_key` is set, an array of found values with keys * corresponding to `$index_key`. If `$index_key` is null, array keys from the original @@ -200,7 +201,7 @@ } /** - * Sorts the list, based on one or more orderby arguments. + * Sorts the input array based on one or more orderby arguments. * * @since 4.7.0 * @@ -238,7 +239,7 @@ } /** - * Callback to sort the list by specific fields. + * Callback to sort an array by specific fields. * * @since 4.7.0 *