_mbsnbicmp, _mbsnbicmp_l
Porovná n bajtů dvě multibajtové znakové řetězce a ignoruje případu.
.gif "Důležitá poznámka") Důležité |
|---|
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v běhovém prostředí systému Windows.Další informace naleznete v tématu CRT funkce nepodporované s /ZW. |
int _mbsnbicmp( const unsigned char *string1, const unsigned char *string2, size_t count );
Parametry
string1, string2
Ukončený hodnotou Null řetězce k porovnání.count
Počet bajtů k porovnání.
Vrácená hodnota
Návratová hodnota udává vztah mezi dílčích řetězců.
Návratová hodnota |
Popis |
|---|---|
< 0 |
string1podřetězec menší než string2 dílčí řetězec. |
0 |
string1podřetězec totožná s string2 dílčí řetězec. |
> 0 |
string1podřetězec větší než string2 dílčí řetězec. |
Na chybu _mbsnbcmp vrátí _NLSCMPERROR, který je definován v String.h a Mbstring.h.
Poznámky
_mbsnbicmp Funkce provádí porovnávání podle pořadového čísla maximálně prvního count bajtů string1 a string2.Porovnání se provádí převedením každý znak na malá písmena; _mbsnbcmp je velká a malá písmena verze _mbsnbicmp.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.
_mbsnbicmp se podobá _mbsnicmp, s tím rozdílem, že porovná řetězce až count bajtů místo podle znaků.
Dva řetězce obsahující znaky umístěné mezi "Z" a 'a' v tabulce ASCII ('[', ' / ', ']', ' ^ ","_", a ''') porovnání lišit v závislosti na jejich případě.Můžete například dva řetězce "ABCDE"a"ABCD^" porovnat jeden ze způsobů, je-li porovnání malá písmena ("abcde" > "abcd^") a jiným způsobem ("ABCDE" < "ABCD^") Pokud je velká písmena.
_mbsnbicmprozpozná multibajtové znakové pořadí podle data více znakové stránky právě používán.Netýká aktuální nastavení národního prostředí.
Pokud buď string1 nebo string2 je ukazatel s hodnotou null, _mbsnbicmp vyvolá obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametru.Pokud je povolena provádění chcete-li pokračovat, vrátí funkce _NLSCMPERROR a nastaví errno k EINVAL.
Mapování rutin obecného textu
Rutina Tchar.h |
_UNICODE a _MBCS nejsou definovány. |
_MBCS definováno |
_UNICODE definováno |
|---|---|---|---|
_tcsnicmp |
_strnicmp |
_mbsnbicmp |
_wcsnicmp |
_tcsnicmp_l |
_strnicmp_l |
_mbsnbicmp_l |
_wcsnicmp_l |
Požadavky
Rutina |
Požadovaný hlavičkový soubor |
|---|---|
_mbsnbicmp |
< mbstring.h > |
Další informace o kompatibilitě, podívejte se na téma kompatibility.
Příklad
Podívejte se na příklad pro _mbsnbcmp, _mbsnbcmp_l.
Ekvivalent v rozhraní .NET Framework
Nelze použít. Pokud chcete volat standardní funkci jazyka C, použijte PInvoke. Další informace naleznete v tématu příklady vyvolat platformy.
Viz také
Referenční dokumentace
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l