asort

(PHP 4, PHP 5, PHP 7)

asort — Сортирует массив, сохраняя ключи

Описание

asort ( array &$array , int $flags = SORT_REGULAR ) : bool

Эта функция сортирует массив таким образом, что сохраняются отношения между ключами и значениями. Она полезна, в основном, при сортировке ассоциативных массивов, когда важно сохранить отношение ключ => значение.

Замечание:
Если оба сравниваемых значения эквивалентны, то порядок их в отсортированном массиве не определен.

Список параметров

array

Входной массив.

flags

Необязательный второй параметр flags может использоваться для изменения поведения сортировки с использованием следующих значений:

Флаги типа сортировки:

SORT_REGULAR - обычное сравнение элементов; подробности описаны в разделе операторы сравнения
SORT_NUMERIC - числовое сравнение элементов
SORT_STRING - строковое сравнение элементов
SORT_LOCALE_STRING - сравнение элементов как строки на основе текущего языкового стандарта. Используется языковой стандарт, который можно изменить с помощью setlocale()
SORT_NATURAL - сравнение элементов как строки, используя "естественный порядок", например natsort()
SORT_FLAG_CASE - можно объединять (побитовое ИЛИ) с SORT_STRING или SORT_NATURAL для сортировки строк без учета регистра

Возвращаемые значения

Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования asort()


<?php
$fruits = array("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple");
asort($fruits);
foreach ($fruits as $key => $val) {
    echo "$key = $val\n";
}
?>

Результат выполнения данного примера:

c = apple
b = banana
d = lemon
a = orange

Названия фруктов были отсортированы в алфавитном порядке и ключи, связанные с элементами, были сохранены.

Смотрите также

arsort() - Сортирует массив в обратном порядке, сохраняя ключи
Сравнение функций сортировки массивов