StrCmpNICA, fonction (shlwapi.h)
Compare un nombre spécifié de caractères à partir du début de deux chaînes à l’aide de règles de classement ASCII (Runtime-time C). La comparaison n’est pas sensible à la casse.
Syntaxe
int StrCmpNICA(
[in] LPCSTR pszStr1,
[in] LPCSTR pszStr2,
int nChar
);
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.
nChar
Type : int
Nombre de caractères du début de chaque chaîne à comparer.
Valeur de retour
Type : int
Retourne zéro si les sous-chaînes sont identiques. Retourne une valeur positive si la chaîne extraite de celle pointée par pszStr1 est par ordre alphabétique supérieure à la chaîne extraite de celle pointée par pszStr2. Retourne une valeur négative si la chaîne extraite de celle pointée par pszStr1 est par ordre alphabétique inférieure à la chaîne extraite de celle vers laquelle pointe pszStr2.
Remarques
Notez que strCmpNIC 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, supposons que pszStr1="abczb », pszStr2="abcdefg », et que vous comparez les quatre premiers caractères de chacun. StrCmpNIC détermine que le premier caractère inégaux est à la position 4 (« z » dans pszStr1 et « d » dans pszStr2) 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 StrCmpNIC dans Shlwapi.h, la version ANSI ou Unicode individuelle de cette fonction doit être appelée directement à partir de Shlwapi.dll. StrCmpNICA est ordinal 153 et StrCmpNICW est ordinal 154.
Note
L’en-tête shlwapi.h définit StrCmpNIC comme 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) |