(PHP 5, PHP 7, PHP 8)
variant_cmp — Сравнивает два варианта
$left,$right,$locale_id = LOCALE_SYSTEM_DEFAULT,$flags = 0
Функция сравнивает значения вариантов в аргументах left с right.
Функция сравнивает только скалярные величины, массивы и записи вариантов не сравниваются.
leftЛевый операнд.
rightПравый операнд.
locale_idДопустимый идентификатор локали, который определит правила сопоставления символов при сравнении строк.
flags
Параметр flags управляет сравнением строк.
В аргументе предают отдельные флаги или объединяют флаги побитовым оператором ИЛИ. Доступны следующие значения:
| Значение | Описание |
|---|---|
NORM_IGNORECASE |
Сравнивать регистронезависимо |
NORM_IGNORENONSPACE |
Игнорировать диакритические знаки и другие комбинируемые символы |
NORM_IGNORESYMBOLS |
Игнорировать символы |
NORM_IGNOREWIDTH |
Игнорировать разницу между полно- и полуширинными символами |
NORM_IGNOREKANATYPE |
Игнорировать тип Кана |
NORM_IGNOREKASHIDA |
Игнорировать символы Кашиды для арабского языка |
Замечание:
Как и в остальных арифметических функциях, которые работают с вариантами, параметры этой функции принимают как встроенные PHP-типы — целые числа, строки, числа с плавающей точкой, логические значения или
null, — так и экземпляры классов COM, VARIANT или DOTNET. Встроенные типы языка PHP преобразуются в варианты по тем же правилам, которые содержит конструктор класса variant. Объекты классов COM и DOTNET получат значение их свойства по умолчанию, которое функция возьмёт и будет использовать как значение варианта.Вариантные арифметические функции — обёртки одноимённых функций библиотеки COM; дополнительную информацию по этим функциям содержит библиотека технической документации MSDN. Названия PHP-функций немного отличаются; например, функция variant_add() в PHP соответствует функции
VarAdd()в документации MSDN.
Возвращает одно из:
| Значение | Описание |
|---|---|
VARCMP_LT |
Значение left меньше
значения right
|
VARCMP_EQ |
Значение left
равно значению right
|
VARCMP_GT |
Значение left
больше значения right
|
VARCMP_NULL |
Одно или оба значения left
и right равны null
|