--- 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
*