« sortuksort »PHP ManualФункції для роботи з масивами

uasort

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

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

Опис

uasort(array &$array, callable $callback): true

Сортує масив array функцією користувача порівняння так, щоб ключі масиву зберігали кореляцію зі значеннями, з якими вони пов'язані.

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

Зауваження :

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

Зауваження :

Скидає внутрішній покажчик масиву перший елемент.

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

array

Вхідний масив

callback

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

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

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

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

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

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

список змін

ВерсияОпис
8.2.0Тип значення, що повертається тепер true; раніше було bool.
8.0.0Тепер функція видасть помилку рівня E_WARNING, якщо параметр callback-функції, переданої у параметр callback, очікує на передачу значення за посиланням.

Приклади

Приклад #1 Простий приклад використання функції 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
)

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