Partager via


_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

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

Routine TCHAR.H

_UNICODE et _MBCS non définis

_MBCS défini

_UNICODE défini

_tcsncicmp

_strnicmp

_mbsnicmp

_wcsnicmp

_tcsnicmp

_strnicmp

_mbsnbicmp

_wcsnicmp

_tcsncicmp_l

_strnicmp_l

_mbsnicmp_l

_wcsnicmp_l

Configuration requise

Routine

En-tête requis

_strnicmp, _strnicmp_l

<string.h>

_wcsnicmp, _wcsnicmp_l

<string.h> ou <wchar.h>

_mbsnicmp, _mbsnicmp_l

<mbstring.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.

Exemple

Consultez l'exemple de strncmp.

Équivalent .NET Framework

System::String::Compare

Voir aussi

Référence

Manipulation de chaînes (CRT)

strcat, wcscat, _mbscat

strcmp, wcscmp, _mbscmp

strcpy, wcscpy, _mbscpy

strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l

strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

strspn, wcsspn, _mbsspn, _mbsspn_l