Edit Report a Bug

Collator::getSortKey

collator_get_sort_key

(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL intl >= 1.0.3)

Collator::getSortKey -- collator_get_sort_key — Получает ключ сортировки строки

Описание

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

public Collator::getSortKey(string $string): string|false

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

collator_get_sort_key(Collator $object, string $string): string|false

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

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

object: Объект Collator.
string: Строка, из которой создаётся ключ.

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

Возвращает ключ сопоставления для строки или false в случае возникновения ошибки.

Внимание

Функция возвращает как логическое значение false, так и нелогическое значение, которое приводится к false. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.

Примеры

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

<?php
$s1 = 'Hello';

$coll = collator_create('en_US');
$res  = collator_get_sort_key($coll, $s1);

echo bin2hex($res);
?>

Вывод приведённого примера будет похож на:

3832404046010901dc08

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

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

add a note

User Contributed Notes

There are no user contributed notes for this page.