Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

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

Remarque importante 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
);

string1, string2

Chaîne terminée par le caractère NULL à comparer.

count

Nombre de caractères à comparer.

locale

Paramètres régionaux à utiliser.

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.

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

Routine de TCHAR.H

_UNICODE et non définis _MBCS

_MBCS défini

_UNICODE défini

_tcsncicmp

_strnicmp

_mbsnicmp

_wcsnicmp

_tcsnicmp

_strnicmp

_mbsnbicmp

_wcsnicmp

_tcsncicmp_l

_strnicmp_l

_mbsnicmp_l

_wcsnicmp_l

Routine

En-tête requis

_strnicmp , _strnicmp_l

<string.h>

_wcsnicmp , _wcsnicmp_l

<string.h> ou <wchar.h>

_mbsnicmp , _mbsnicmp_l

<mbstring.h>

Pour des informations de compatibilité supplémentaires, consultez Compatibilité.

Consultez l'exemple pour strncmp.

Ajouts de la communauté

AJOUTER
Afficher: