asort

    (PHP 4, PHP 5, PHP 7, PHP 8)

    asort — Сортирует массив в порядке возрастания, сохраняя ассоциацию индексов

    Описание

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

    Сортирует массив (array) в порядке возрастания так, чтобы ключи массива сохраняли корреляцию со значениями, с которыми они связаны.

    Функцией пользуются для сортировки ассоциативных массивов, для которых важен текущий порядок элементов.

    Замечание:

    Функция сохраняет первоначальный порядок элементов, если при сравнении значения двух элементов равны. До PHP 8.0.0 порядок элементов в отсортированном массиве оставался неопределённым.

    Замечание:

    Функция сбрасывает внутренний указатель массива на первый элемент.

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

    array

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

    flags

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

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

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

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

    Функция всегда возвращает true.

    Список изменений

    ВерсияОписание
    8.2.0 Тип возвращаемого значения теперь true; ранее было bool.

    Примеры

    Пример #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

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

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

    To Top