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

# ArrayIterator::uasort

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

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

### Описание

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

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

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

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

`callback`
  Функция сравнения должна возвращать целое, которое меньше, равно или больше нуля, если первый аргумент является соответственно меньшим, равным или большим, чем второй.
  function callback(mixed `$a`, mixed `$b`): int
  Предостережение

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

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

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

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

Версия | Описание
--- | ---
8.2.0 | Вместо общего логического типа bool теперь возвращается конкретный тип `true`.

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open