(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
|