_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Compare le nombre spécifié de caractères de deux chaînes sans tenir compte de la casse.

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

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 '`') é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 Locale.

Toutes ces fonctions valident leurs paramètres. Si le paramètre string1 ou string2 est un pointeur null, le Gestionnaire de paramètre non valide 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
RoutineEn-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é.

Consultez l’exemple de strncmp.

System::String::compare

Manipulation de chaînes
strcat, wcscat, _mbscat
strcmp, wcscmp, _mbscmp
strcpy, wcscpy, _mbscpy
strncnt, _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

Afficher: