Fonction StrCmpICW (shlwapi.h)

Compare deux chaînes à l’aide de règles de classement au moment de l’exécution C (ASCII). La comparaison ne respecte pas la casse.

Syntaxe

int StrCmpICW(
  [in] LPCWSTR pszStr1,
  [in] LPCWSTR pszStr2
);

Paramètres

[in] pszStr1

Type : LPCTSTR

Pointeur vers la première chaîne terminée par null à comparer.

[in] pszStr2

Type : LPCTSTR

Pointeur vers la deuxième chaîne terminée par null à comparer.

Valeur retournée

Type : int

Retourne zéro si les chaînes sont identiques. Retourne une valeur positive si la chaîne pointée par lpStr1 est par ordre alphabétique supérieure à celle pointée par lpStr2. Retourne une valeur négative si la chaîne pointée par lpStr1 est par ordre alphabétique inférieure à celle pointée par lpStr2

Remarques

Il est vivement recommandé d’utiliser CompareString à la place de cette fonction. StrCmpIC a été conçu pour comparer des chaînes canoniques. Ces chaînes ne sont pas localisées et se composent uniquement de caractères inférieurs à la valeur ASCII 128. Par conséquent, il ne fonctionnera pas correctement avec les données de jeu de caractères double octet (DBCS).

Les caractères majuscules sont convertis en minuscules avant la comparaison, et la valeur de retour est basée sur la comparaison des valeurs converties. Cette fonction retourne la différence de valeur des premiers caractères inégaux qu’elle rencontre, ou zéro s’ils sont tous égaux. Par exemple, si lpStr1="abczb » et lpStr2="abcdefg », StrCmpIC détermine que « abczb » est supérieur à « abcdefg » et retourne z -d.

Pour les versions de Windows qui n’incluent pas StrCmpIC dans Shlwapi.h, la version ANSI ou Unicode individuelle de cette fonction doit être appelée directement à partir de Shlwapi.dll. StrCmpICA est ordinal 157 et StrCmpICW est ordinal 158.

Configuration requise

Voir aussi

CompareString