_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Article
03/26/2013

Compare les caractères de deux chaînes sans tenir compte du cas.

Important

_mbsnicmp et _mbsnicmp_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

int _strnicmp(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicmp(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsnicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicmp_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicmp_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsnicmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Paramètres

string1, string2
Chaîne terminée par le caractère NULL à comparer.
count
Nombre de caractères à comparer.
locale
Paramètres régionaux à utiliser.

Valeur de retour

Indique la relation entre les sous-chaînes, comme suit.

Valeur de retour	Description
< 0	la sous-chaîne d'string1 est moins que la sous-chaîne d' string2 .
0	la sous-chaîne d'string1 identique à la sous-chaîne d' string2 .
> 0	la sous-chaîne d'string1 est supérieure à la sous-chaîne d' string2 .

Sur une erreur, _mbsnicmp retourne _NLSCMPERROR, qui est définie dans STRING.H et MBSTRING.H.

Notes

La fonction d' _strnicmp compare lexicographique, au plus, les premiers caractères d' count d' string1 et string2.La comparaison est exécutée sans tenir compte du cas ; _strnicmp est une version non sensible à la casse d' strncmp.La comparaison terminée si un caractère NULL de fin est atteint dans l'un ou l'autre de chaîne avant les caractères d' count sont comparés.Si les chaînes sont égales lorsqu'un caractère NULL de fin est atteint dans l'un ou l'autre de chaîne avant les caractères d' count sont comparés, la chaîne plus courte est moins.

Les caractères de 91 à 96 dans le tableau ASCII (" [ », « \ », « ] », « ^ », « _ », et « '') valeur comme moins qu'une lettre.Cette classe qui est identique à celui d' stricmp.

_wcsnicmp et _mbsnicmp sont à caractères larges et des versions à caractères multioctets d' _strnicmp.Les arguments et la valeur de retour d' _wcsnicmp sont des chaînes à caractères larges ; ces d' _mbsnicmp sont des chaînes de caractères multioctets._mbsnicmp identifie les séquences de caractères multioctets d'après la page de codes multioctets en cours et retourne _NLSCMPERROR sur une erreur.Pour plus d'informations, consultez Pages de codes.Ces trois fonctions se comportent de sinon.Ces fonctions sont affectées par les versions de configuration - le de paramètres régionaux qui n'ont pas l'utilisation de suffixe d' _l les paramètres régionaux définis pour leur comportement dépendant des paramètres régionaux ; les versions qui font utiliser le suffixe d' _l à la place les paramètres régionaux passés dans.Pour plus d'informations, consultez Paramètres régionaux.

Toutes ces fonctions valident leurs paramètres.Si string1 ou string2 est un pointeur null, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, ces fonctions _NLSCMPERROR de retour et affectez errno à EINVAL.

Mappages de routines de texte générique