PHP 8.4.1 Released!

variant_cmp

(PHP 5, PHP 7, PHP 8)

variant_cmpСравнить два варианта

Описание

variant_cmp(
    mixed $left,
    mixed $right,
    int $locale_id = LOCALE_SYSTEM_DEFAULT,
    int $flags = 0
): int

Сравнивает 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

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top