Edit Report a Bug

Collator::asort

collator_asort

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

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

Описание

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

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

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

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 и ключей сортировки

add a note

User Contributed Notes 1 note

down

-1

alix dot axel at NOSPAM dot gmail dot com ¶

13 years ago


For those of you who are looking for a way to integrate natural sorting with the UCA rules this hack seems to work:

<?php

$array = array
(
    '1', '100',
    'al', 'be',
    'Alpha', 'Beta',
    'Álpha', 'Àlpha', 'Älpha',
    'かたかな',
    'img1.png', 'img2.png',
    'img10.png', 'img20.png'
);

echo '<pre>';
print_r(sortIntl($array, true));
echo '</pre>';

function sortIntl($array, $natural = true)
{
    $data = $array;

    if ($natural === true)
    {
        $data = preg_replace_callback('~([0-9]+)~', 'natsortIntl', $data);
    }

    collator_asort(collator_create('root'), $data);

    return array_intersect_key($array, $data);
}

function natsortIntl($number)
{
    return sprintf('%032d', $number);
}

?>

Output:

Array
(
    [0] => 1
    [1] => 100
    [2] => al
    [3] => be
    [4] => Alpha
    [5] => Beta
    [6] => Álpha
    [7] => Àlpha
    [8] => Älpha
    [9] => かたかな
    [10] => img1.png
    [11] => img2.png
    [12] => img10.png
    [13] => img20.png
)

add a note