ArrayObject::uasort

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

ArrayObject::uasort — Сортувати записи, використовуючи функцію користувача для порівняння елементів і зберігаючи при цьому зв'язок ключ/значення

Опис

public ArrayObject::uasort(callable $callback): true

Ця функція сортує значення зі збереженням ключів, використовуючи функцію порівняння.

Функція використовується в основному при сортуванні асоціативних масивів, в яких важливим є актуальний порядок елементів.

Зауваження :

Якщо обидва порівнювані значення еквівалентні, вони зберігають свій початковий порядок. До PHP 8.0.0 їх відносний порядок у відсортованому масиві не було визначено.

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

callback

Функція порівняння повинна повертати ціле, яке менше, дорівнює чи більше нуля, якщо перший аргумент є відповідно меншим, рівним чи більшим, ніж другий.

callback(mixed $a, mixed $b): int

Застереження

Возвращениенецілих значень з функції порівняння, таких як число з плаваючою точкою (float), призведе до внутрішнього приведення значення callback-функції, що повертається, до цілого числа (int). Таким чином, значення 0.99и0.1 будуть приведені до цілого значення що дозволить порівняти ці значення як рівні.

Значення, що повертаються

Функція завжди повертає true

список змін

Версия	Опис
8.2.0	Тип значення, що повертається тепер true; раніше було bool.

Приклади

Приклад #1 Приклад використання ArrayObject::uasort()****

Loading...
▶

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

Array
(
    [a] => 4
    [b] => 8
    [c] => -1
    [d] => -9
    [e] => 2
    [f] => 5
    [g] => 3
    [h] => -4
)
Array
(
    [d] => -9
    [h] => -4
    [c] => -1
    [e] => 2
    [g] => 3
    [a] => 4
    [f] => 5
    [b] => 8
)

Дивіться також

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