variant_cmp

(PHP 5)

variant_cmp --  Compares two variants

Description

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

Compares left with right and returns one of the following values:

Tableau 1. Variant Comparision Results

valuemeaning
VARCMP_LTleft is less than right
VARCMP_EQleft is equal to right
VARCMP_GTleft is greater than right
VARCMP_NULLEither left, right or both are NULL

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

lcid is a valid Locale Identifier to use when comparing strings (this affects string collation). flags can be one or more of the following values OR'd together, and affects string comparisons:

Tableau 2. Variant Comparision Flags

valuemeaning
NORM_IGNORECASECompare case insensitively
NORM_IGNORENONSPACEIgnore nonspacing characters
NORM_IGNORESYMBOLSIgnore symbols
NORM_IGNOREWIDTHIgnore string width
NORM_IGNOREKANATYPEIgnore Kana type
NORM_IGNOREKASHIDAIgnore Arabic kashida characters

Note : Tout comme les fonctions arithmétiques, les paramètres de cette fonction peuvent être soit un type natif de PHP (entier, chaîne de caractères, nombre à virgule flotante, booléen ou NULL), ou une instance d'une classe COM, VARIANT ou DOTNET. Les types natifs de PHP seront convertis en classe VARIANT en utilisant les mêmes rouages que ceux trouvés dans le constructeur de variant la classe. Les objets COM et DOTNET auront les valeurs de leurs proriétés par défaut et seront utilisés dans les valeurs des VARIANT.

Les fonctions arithmétiques VARIANT sont transposés sur des fonctions nommées de la même façon dans la librairie COM ; pour plus d'informations sur ces fonctions, consultez la librairie MSDN. Les fonctions PHP sont nommées légèrement différemment ; par exemple variant_add() en PHP correspond à VarAdd() dans la documentation MSDN.