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 типами (integer, string, floating point, boolean или null), так и экземплярами классов COM, VARIANT или DOTNET. Родные PHP типы будут преобразованы в варианты (variants) по тем же самым правилам, что и в конструкторе класса variant. У объектов COM и DOTNET будет взято и использовано их значение по умолчанию в качестве значения варианта.

Вариантные арифметические функции являются обёртками вокруг одноимённых функций в библиотеке COM; для более подробной информации по этим функциям проконсультируйтесь с библиотекой MSDN. Названия PHP-функций немного отличаются; например, variant_add() в PHP соответствует VarAdd() в документации MSDN.

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

Возвращает одно из:

Результаты сравнения вариантов
значениеописание
VARCMP_LTleft меньше чем right
VARCMP_EQleft идентичен right
VARCMP_GTleft больше чем right
VARCMP_NULLОба значения left и right равны null
To Top