variant_cmp

(PHP 5, PHP 7)

variant_cmpCompares two variants

Descrierea

variant_cmp ( mixed $left , mixed $right [, int $lcid [, int $flags ]] ) : int

Compares left with right.

This function will only compare scalar values, not arrays or variant records.

Parametri

left

The left operand.

right

The right operand.

lcid

A valid Locale Identifier to use when comparing strings (this affects string collation).

flags

flags can be one or more of the following values OR'd together, and affects string comparisons:

Variant Comparision Flags
value meaning
NORM_IGNORECASE Compare case insensitively
NORM_IGNORENONSPACE Ignore nonspacing characters
NORM_IGNORESYMBOLS Ignore symbols
NORM_IGNOREWIDTH Ignore string width
NORM_IGNOREKANATYPE Ignore Kana type
NORM_IGNOREKASHIDA Ignore Arabic kashida characters

Notă:

Ca și în cazul tuturor funcțiilor aritmetice de variante, parametrii pentru această funcție pot fi sau de un tip PHP indigen (integer, string, floating point, boolean sau NULL), sau o instanță a claselor COM, VARIANT sau DOTNET. Tipurile PHP indigene vor fi convertite în variante utilizând aceleași reguli ca și cele din constructorul VARIANT clasei. De la obiectele COM și DOTNET se va lua valoarea proprietății lor implicite și va fi utilizată ca valoare a variantei.

Funcțiile aritmetice ale variantelor sunt niște învelișuri ale funcțiilor denumite similar în biblioteca COM; pentru informații suplimentare despre aceste funcții consultați biblioteca MSDN. Funcțiile PHP sunt denumite un pic diferit; spre exemplu, variant_add() din PHP corespunde cu VarAdd() în documentația MSDN.

Valorile întoarse

Returns one of the following:

Variant Comparision Results
value meaning
VARCMP_LT left is less than right
VARCMP_EQ left is equal to right
VARCMP_GT left is greater than right
VARCMP_NULL Either left, right or both are NULL