_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Článek
03/26/2013

Porovnává znaky dvou řetězců bez ohledu na případ.

Důležité
_mbsnicmpa _mbsnicmp_l nelze použít v aplikacích, které jsou spuštěny v Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /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
);

Parametry

string1, string2
Řetězce zakončené znakem null pro porovnání.
count
Počet znaků, které chcete porovnat.
locale
Chcete-li národní prostředí pro použití.

Vrácená hodnota

Označuje vztah mezi podřetězců, takto.

Vrácená hodnota	Description
< 0	string1podřetězec je menší než string2 podřetězec.
0	string1podřetězec je totožný s string2 podřetězec.
> 0	string1podřetězec je větší než string2 podřetězec.

Na chybu _mbsnicmp vrátí _NLSCMPERROR, který je definován v ŘETĚZCI.H a MBSTRING.H.

Poznámky

_strnicmp Funkce lexicographically porovná, nanejvýš první count znaky string1 a string2.Porovnání je provedeno bez ohledu na případ. _strnicmpje velká a malá písmena verze strncmp.Ukončí porovnání ukončující znak null není-li dosaženo buď řetězce před count znaky jsou porovnávány.Pokud jsou řetězce shodné při ukončující znak null je dosaženo buď řetězce před count znaky jsou porovnávány, kratší řetězec je menší.

Znaky z 91 96 v tabulce ASCII ("[", "\", "]", "^", "_" a "") vyhodnotit jako nižší než abecední znak.Toto pořadí je stejná jako stricmp.

_wcsnicmpa _mbsnicmp jsou verze širokého znaku a vícebajtové znakové sady _strnicmp.Argumenty a vrácené hodnoty _wcsnicmp jsou řetězci širokého znaku; u _mbsnicmp jsou vícebajtové znakové řetězce._mbsnicmprozpozná vícebajtové znakové sekvence podle aktuální vícebajtová znaková stránka a vrátí _NLSCMPERROR na chybu.Další informace naleznete v tématu Kódové stránky.Tyto tři funkce chovat identicky jinak.Tyto funkce jsou ovlivněny nastavením národního prostředí – verze, které nemají _l příponu použít aktuální národní prostředí pro jejich chování závislé na národním prostředí; verze, které mají _l příponu místo toho použít národní prostředí, který je předán v.Další informace naleznete v tématu Národní prostředí.

Všechny tyto funkce ověření jejich parametrů.Pokud string1 nebo string2 je ukazatel s hodnotou null, je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno zpracování, chcete-li pokračovat, tyto funkce vracejí _NLSCMPERROR a errno na EINVAL.

Mapování rutiny obecného textu