StrCmpCA, fonction (shlwapi.h)

Article
11/20/2024

Compare les chaînes à l’aide de règles de classement ASCII (Run-time) C. La comparaison respecte la casse.

Syntaxe

int StrCmpCA(
  [out] LPCSTR pszStr1,
  [out] LPCSTR pszStr2
);

Paramètres

[out] pszStr1

Type : LPCSTR

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

[out] pszStr2

Type : LPCSTR

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

Valeur de retour

Type : int

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

Remarques

Il est fortement recommandé d’utiliser la fonction CompareString à la place de cette fonction. strCmpC 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, elle ne fonctionnera pas correctement avec un jeu de caractères double octet (DBCS) ou d’autres données à caractères multiples.

Cette fonction localise les premiers caractères inégaux et retourne un nombre positif si le caractère de la première chaîne est supérieur au caractère de la seconde, un nombre négatif s’il est inférieur ou égal à zéro. Par exemple, si lpStr1="abczb » et lpStr2="abcdefg », StrCmpC détermine que le premier caractère inégaux est à la position 4 (« z » dans lpStr1 et « d » dans lpStr2) et retourne une valeur positive, car le code ASCII pour « z » est supérieur au code ASCII pour « d ».

Pour les versions de Windows qui n’incluent pas strCmpC dans Shlwapi.h, la version ANSI ou Unicode individuelle de cette fonction doit être appelée directement à partir de Shlwapi.dll. strCmpCA est ordinal 155 et StrCmpCW est ordinal 156.

Note

L’en-tête shlwapi.h définit StrCmpC en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Voir aussi

compareString

Partager via