variant_cmp

(PHP 5, PHP 7)

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_LT left меньше чем right
VARCMP_EQ left идентичен right
VARCMP_GT left больше чем right
VARCMP_NULL Оба значения left и right равны null