variant_cmp

(PHP 5)

variant_cmp --  Compare deux variants

Description

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

Compare left avec right et retourne une des valeurs suivantes :

Tableau 1. Résultats des comparaisons sur variants

ValeurSignification
VARCMP_LTleft est plus petit que right
VARCMP_EQleft est égal à right
VARCMP_GTleft est plus grand que right
VARCMP_NULLleft, right ou les deux sont NULL

Cette fonction ne comparera que des valeurs scalaires, pas de tableaux ni d'enregistrements variants.

lcid est un Locale Identifier valide à utiliser lors des comparaisons des chaînes (cela affecte la collation de la chaîne). flags peut être une ou plusieurs des valeurs suivantes, jointes avec des OR, et affecte les comparaisons de chaînes :

Tableau 2. Options de comparaison Variant

ValeurSignification
NORM_IGNORECASECompare avec sensibilité à la casse
NORM_IGNORENONSPACEIgnore les caractères non-espaceants
NORM_IGNORESYMBOLSIgnore les symboles
NORM_IGNOREWIDTHIgnore la taille de la chaîne
NORM_IGNOREKANATYPEIgnore le type de Kana
NORM_IGNOREKASHIDAIgnore les caractères arabes kashida

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 bibliothèque COM ; pour plus d'informations sur ces fonctions, consultez la bibliothèque MSDN. Les fonctions PHP sont nommées légèrement différemment ; par exemple variant_add() en PHP correspond à VarAdd() dans la documentation MSDN.