Partager via


Fonction StrCmpNA (shlwapi.h)

Compare un nombre spécifié de caractères à partir du début de deux chaînes pour déterminer s’ils sont identiques. La comparaison respecte la casse. La macro StrNCmp diffère de cette fonction uniquement par son nom.

Syntaxe

int StrCmpNA(
  [in] PCSTR psz1,
  [in] PCSTR psz2,
  [in] int   nChar
);

Paramètres

[in] psz1

Type : PCTSTR

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

[in] psz2

Type : PCTSTR

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

[in] nChar

Type : int

Nombre de caractères du début de chaque chaîne à comparer.

Valeur retournée

Type : int

Retourne zéro si les chaînes sont identiques. Retourne une valeur positive si les premiers caractères nChar de la chaîne pointée par psz1 sont supérieurs à ceux de la chaîne pointée vers psz2. Elle retourne une valeur négative si les premiers caractères nChar de la chaîne pointée par psz1 sont inférieurs à ceux de la chaîne pointée vers psz2.

Remarques

Notes

L’en-tête shlwapi.h définit StrCmpN comme un 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlwapi.h
Bibliothèque Shlwapi.lib
DLL Shlwapi.dll (version 4.71 ou ultérieure)