_mbsnbicmp _mbsnbicmp_l

Článek
03/26/2013

Porovnává n bajtů dva vícebajtové znakové řetězce, ignoruje případu.

Důležité
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v systému Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

int _mbsnbicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);

Parametry

string1, string2
Řetězce zakončené znakem null pro porovnání.
count
Počet bajtů k porovnání.

Vrácená hodnota

Vrácená hodnota označuje vztah mezi podřetězce.

Vrácená hodnota	Description
< 0	string1podřetězec menší než string2 podřetězec.
0	string1podřetězce, které jsou shodné s string2 podřetězec.
> 0	string1podřetězce, které jsou větší než string2 podřetězec.

Na chybu _mbsnbcmp vrátí _NLSCMPERROR, která je definována v String.h a Mbstring.h.

Poznámky

_mbsnbicmp Funkce lexicographically porovná, nanejvýš první count bajtů string1 a string2.Porovnání je provedeno bez ohledu na případ. _mbsnbcmpje velká a malá písmena verze _mbsnbicmp.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ší.

_mbsnbicmpje podobný _mbsnicmp, s tím rozdílem, že porovná řetězec podle bajtů namísto znaků.

Dva řetězce obsahující znaky umístěné mezi "Z" a "a" v tabulce ASCII ("[", "\", "]", "^", "_", a ''') porovnat různě, v závislosti na jejich případu.Například dva řetězce "ABCDE"a"ABCD^" porovnat jeden ze způsobů, je-li srovnání malými písmeny ("abcde" > "abcd^") and the other way ("ABCDE" < "ABCD^") v případě, že je velká.

_mbsnbicmprozpozná vícebajtové znakové sekvence podle vícebajtová znaková stránka palivu.Není ovlivněna aktuální nastavení národního prostředí.

Pokud string1 nebo string2 je nulový ukazatel, _mbsnbicmp vyvolá obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno zpracování, chcete-li pokračovat, vrátí funkce _NLSCMPERROR a errno na EINVAL.

Mapování rutiny obecného textu