ArrayIterator::uasort

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

ArrayIterator::uasort — Сортировка с помощью заданной пользователем функции и сохранением ключей

Описание

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

Сортирует записи в массиве по значениям, используя функцию сортировки, определённую пользователем и сохраняя связь ключ-значение.

Замечание:

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

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

callback

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

callback(mixed $a, mixed $b): int
Предостережение

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

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

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

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

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

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

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