array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.variant-cmp.php', 1 => 'variant_cmp', ), 'up' => array ( 0 => 'ref.com.php', 1 => 'Функции COM', ), 'prev' => array ( 0 => 'function.variant-cat.php', 1 => 'variant_cat', ), 'next' => array ( 0 => 'function.variant-date-from-timestamp.php', 1 => 'variant_date_from_timestamp', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/com/functions/variant-cmp.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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 типами (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
|