Collator::compare
collator_compare
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Collator::compare -- collator_compare — Порівнює два рядки Unicode
Опис
Об'єктно-орієнтований стиль
public Collator::compare(string $string1, string $string2): int|false
Процедурний стиль
collator_compare(Collator $object, string $string1, string $string2): int|false
Порівнює два рядки Unicode відповідно до правил зіставлення.
Список параметрів
object
Об'єкт Collator
string1
Перший рядок для порівняння.
string2
Другий рядок для порівняння.
Значення, що повертаються
Повертає результат порівняння:
-
1, якщо
string1більшеstring2 -
0, якщо
string1дорівнюєstring2 -
-1, якщо
string1меншеstring2
У разі виникнення помилки повертає false
Увага
Ця функція може повертати як логічне значення **false**так і значення не типу boolean, яке наводиться до false. За більш детальною інформацією зверніться до розділу Логічний типИспользуйтеоператор === для перевірки значення, яке повертається цією функцією.
Приклади
Приклад #1 Приклад використання collator_compare()****
Результат виконання наведеного прикладу:
s1 больше s2
Приклад #2 Порівняння рядків без діакритичних знаків та без урахування регістру
Результат виконання наведеного прикладу:
Значення рівні
У цьому прикладі Collator порівнює, враховуючи лише базові символи. Документація для Collator->setStrength() пояснює різні сильні сторони.
Дивіться також
- collator_sort() - Сортує масив із використанням зазначеного засобу сортування