функция
since 4.7.0
wp_list_sort()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_list_sort( array $input_list, string|array $orderby = array(), string $order = 'ASC', bool $preserve_keys = false ): arrayОписание
Сортирует массив объектов или массивов по одному или нескольким аргументам orderby.
Параметры
$input_list
array
обязательный
Массив объектов или массивов для сортировки.
$orderby
string|array
необязательный
= array()
Либо имя поля для сортировки, либо массив из нескольких полей сортировки в виде $orderby => $order.
$order
string
необязательный
= 'ASC'
Либо 'ASC', либо 'DESC'. Используется только если $orderby — строка. Значение по умолчанию 'ASC'.
$preserve_keys
bool
необязательный
= false
Нужно ли сохранять ключи.
Возвращаемое значение
array
Исходный код
wp-includes/functions.php:5419
function wp_list_sort( $input_list, $orderby = array(), $order = 'ASC', $preserve_keys = false ) {
if ( ! is_array( $input_list ) ) {
return array();
}
$util = new WP_List_Util( $input_list );
return $util->sort( $orderby, $order, $preserve_keys );
}История изменений
| Версия | Описание |
|---|---|
| 4.7.0 | Introduced. |
