Edit Report a Bug

    ArrayObject::ksort

    (PHP 5 >= 5.2.0, PHP 7, PHP 8)

    ArrayObject::ksort — Сортировать записи по ключам

    Описание

    public ArrayObject::ksort(int $flags = SORT_REGULAR): true

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

    Замечание:

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

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

    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 Пример использования ArrayObject::ksort()

    <?php
    $fruits     = array("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple");
    $fruitArrayObject = new ArrayObject($fruits);
    $fruitArrayObject->ksort();

    foreach (    $fruitArrayObject as $key => $val) {
    echo     "$key = $val\n";
    }
    ?>

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

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

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

    • ArrayObject::asort() - Сортировать записи по значению
    • ArrayObject::natsort() - Сортировать массив, используя алгоритм "natural order"
    • ArrayObject::natcasesort() - Сортировать массив, используя регистронезависимый алгоритм "natural order"
    • ArrayObject::uasort() - Сортировать записи, используя пользовательскую функцию для сравнения элементов и сохраняя при этом связь ключ/значение
    • ArrayObject::uksort() - Сортировать массив по ключам, используя пользовательскую функцию для сравнения
    • ksort() - Сортирует массив по ключу в порядке возрастания

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top