_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Article
06/09/2015

Compare les caractères de deux chaînes sans tenir compte de la casse.

Important

Les fonctions _mbsnicmp et _mbsnicmp_l ne peuvent pas être utilisées dans les applications qui s'exécutent dans Windows Runtime.Pour plus d'informations, voir Fonctions CRT non prises en charge avec /ZW (éventuellement en anglais).

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 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 de string1 est inférieure à la sous-chaîne de string2.
0	La sous-chaîne de string1 est identique à la sous-chaîne de string2.
> 0	La sous-chaîne de string1 est supérieure à la sous-chaîne de string2.

En cas d'erreur de validation de paramètre, ces fonctions retournent _NLSCMPERROR, qui est défini dans <string.h> et dans <mbstring.h>.

Notes

La fonction ordinale _strnicmp compare, au plus, les premiers count caractères de string1 et de string2. La comparaison est effectuée sans tenir compte de la casse, en convertissant chaque caractère en minuscule. _strnicmp est une version de strncmp respectant la casse. La comparaison se termine si un caractère null de fin est atteint dans l'une ou l'autre des chaînes avant que count caractères soient comparés. Si les chaînes sont égales quand un caractère null de fin est atteint dans l'une ou l'autre des chaînes avant que count caractères soient comparés, la chaîne la plus courte est considérée comme étant inférieure.

Les caractères de 91 à 96 de la table ASCII (« [ », « \ », « ] », « ^ », « _ » et « ' ») sont évalués comme étant inférieurs à n'importe quel caractère alphabétique. Ce classement est identique à celui de stricmp.

_wcsnicmp et _mbsnicmp sont des versions à caractères larges et à caractères multioctets de _strnicmp. Les arguments de _wcsnicmp sont des chaînes de caractères larges ; ceux de _mbsnicmp sont des chaînes de caractères multioctets. _mbsnicmp reconnaît les séquences de caractères multioctets selon la page de codes multioctets active et retourne _NLSCMPERROR en cas d'erreur. Pour plus d'informations, consultez Pages de codes. Ces trois fonctions se comportent sinon de façon identique. Ces fonctions sont affectées par les paramètres régionaux : les versions qui n'ont pas le suffixe _l utilisent les paramètres régionaux actuels pour leur comportement dépendant des paramètres régionaux et les versions qui ont le suffixe _l utiliser le paramètre locale qui est passé en entrée. 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ètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, ces fonctions retournent _NLSCMPERROR et définissent errno avec la valeur EINVAL.

Mappages de routines de texte générique