Сортирует массив с сохранением ассоциации индекса

# Collator::asort

# collator_asort

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Collator::asort -- collator_asort — Сортирует массив с сохранением ассоциации индекса

### Описание

Объектно-ориентированный стиль

public function Collator::asort(array `&$array`, int `$flags` = `Collator::SORT_REGULAR`): bool

Процедурный стиль

function collator_asort(Collator `$object`, array `&$array`, int `$flags` = `Collator::SORT_REGULAR`): bool

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

Эквивалентно стандартной функции PHP asort().

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

`object`

  Объект Collator.

`array`

  Массив строк для сортировки.

`flags`

  Необязательный тип сортировки, один из следующих:

  - `Collator::SORT_REGULAR` - сравнивает элементы как обычно (не изменяя тип)

  - `Collator::SORT_NUMERIC` - сравнивает элементы, как числа

  - `Collator::SORT_STRING` - сравнивает элементы, как строки

  Значение `flags` по умолчанию - `Collator::SORT_REGULAR`. Также используется, если указано недопустимое значение `flags`.

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

Функция возвращает `true`, если выполнилась успешно, или `false`, если возникла ошибка.

### Примеры

Пример #1 Пример использования collator_asort()

    <?php
    $coll = collator_create( 'en_US' );
    $arr = array(
         'a' => '100',
         'b' => '50',
         'c' => '7'
    );
    collator_asort( $coll, $arr, Collator::SORT_NUMERIC );
    var_export( $arr );

    collator_asort( $coll, $arr, Collator::SORT_STRING );
    var_export( $arr );
    ?>

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

    array (
      'c' => '7',
      'b' => '50',
      'a' => '100',
    )array (
      'a' => '100',
      'b' => '50',
      'c' => '7',
    )

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

- Константы Collator
- collator_sort() - Сортирует массив с использованием указанного средства сортировки
- collator_sort_with_sort_keys() - Сортирует массив с использованием указанного Collator и ключей сортировки

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