_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Článek
06/09/2015

Porovná znaky dvou řetězců bez ohledu na to případu.

Důležité
_mbsnicmpa _mbsnicmp_l nelze použít v aplikacích, které jsou spuštěny v prostředí Windows Runtime.Další informace naleznete v tématu CRT funkce nepodporované 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
Ukončený hodnotou Null řetězce k porovnání.
count
Počet znaků, které mají být porovnány.
locale
Národní prostředí má použít.

Vrácená hodnota

Označuje vztah mezi dílčích řetězců, takto.

Návratová hodnota	Popis
< 0	string1podřetězec je menší než string2 dílčí řetězec.
0	string1podřetězec je stejná jako string2 dílčí řetězec.
> 0	string1dílčí řetězec je větší než string2 dílčí řetězec.

Na Chyba ověření parametru, vrátí tyto funkce _NLSCMPERROR, který je definován v < string.h > a < mbstring.h >.

Poznámky

_strnicmp Funkce ordinally porovná, maximálně první count znaky string1 a string2.Porovnání se provádí bez ohledu na to případ převedením každý znak na malá písmena._strnicmpje velká a malá písmena verze strncmp.Porovnání skončí, pokud je dosaženo ukončující znak null v buď řetězec před count se pak porovnávají znaků.Pokud jsou řetězce shodné při dosažení ukončující znak null v buď řetězec před count znaky jsou porovnávány, předchází zkrátit řetězec.

Znaky z 91 96 v tabulce ASCII ('[', ' / ', ']', ' ^ ","_", a ''') vyhodnotit jako menší než libovolný znak abecedy.Toto pořadí je shodná s stricmp.

_wcsnicmpa _mbsnicmp jsou širokého znaku a multibajtové znakové verze _strnicmp.Argumenty _wcsnicmp jsou řetězce širokého znaku; u _mbsnicmp jsou multibajtové znakové řetězce._mbsnicmprozpozná multibajtové znakové pořadí podle aktuální více znakovou stránku a vrátí _NLSCMPERROR na chybu.Další informace naleznete v tématu Znakové stránky.Tyto tři funkce chovat stejně jako v opačném případě.Tyto funkce jsou ovlivněny nastavení národního prostředí – verzemi, které nemají _l přípona použít aktuální národní prostředí pro jejich chování národní prostředí závislé; verze, které mají _l příponu místo toho použijte locale který je předán.Další informace naleznete v tématu Národní prostředí.

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

Mapování rutin obecného textu