Collator::sort

collator_sort

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

Collator::sort -- collator_sort — Сортирует массив с использованием указанного средства сортировки

Описание

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

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

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

collator_sort(Collator $object, array &$array, int $flags = Collator::SORT_REGULAR): bool

Функция сортирует массив в соответствии с текущими правилами локали.

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

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

object

Объект Collator.

array

Array of strings to sort.

flags

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

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

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

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

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

Примеры

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

<?php
$coll = collator_create( 'en_US' );
$arr  = array( 'at', 'às', 'as' );

var_export( $arr );
collator_sort( $coll, $arr );
var_export( $arr );
?>

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

array (
  0 => 'at',
  1 => 'às',
  2 => 'as',
)array (
  0 => 'as',
  1 => 'às',
  2 => 'at',
)

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

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