_mbsbtype, _mbsbtype_l

Článek
06/09/2015

Vrátí typ bajtu v rámci řetězce.

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

int _mbsbtype(
   const unsigned char *mbstr,
   size_t count 
);
int _mbsbtype_l(
   const unsigned char *mbstr,
   size_t count,
   _locale_t locale 
);

Parametry

mbstr
Adresa sekvence vícebajtových znaků.
count
Posun bajtu od záhlaví řetězce.
locale
Použité národní prostředí.

Vrácená hodnota

_mbsbtype a _mbsbtype_lvrátí celočíselnou hodnotu označující výsledek testu na zadaném bajtu.Konstanty manifestu v následující tabulce jsou definovány v souboru Mbctype.h.

Návratová hodnota	Typ bajtu
_MBC_SINGLE (0)	Jednobajtový znak.Například v kódové stránce 932 _mbsbtype vrátí hodnotu 0, pokud je zadaný bajt rozsahu 0x20 – 0x7E nebo 0xA1 – 0xDF.
_MBC_LEAD (1)	Vedoucí bajt vícebajtového znaku.Například v kódové stránce 932 _mbsbtype vrátí hodnotu 1, pokud je zadaný bajt rozsahu 0x81 – 0x9F nebo 0xE0 – 0xFC.
_MBC_TRAIL (2)	Koncový bajt vícebajtového znaku.Například v kódové stránce 932 _mbsbtype vrátí hodnotu 2, pokud je zadaný bajt rozsahu 0x40 – 0x7E nebo 0x80 – 0xFC.
_MBC_ILLEGAL (–1)	Řetězec NULL, neplatný znak nebo bajt NULL nalezený před bajtem na posunu count v mbstr.

Poznámky

Funkce _mbsbtype určuje typ bajtu ve vícebajtovém znakovém řetězci.Funkce zkontroluje bajt na posunu count v mbstr a ignoruje neplatné znaky před zadaným bajtem.

Výstupní hodnota je ovlivněna nastavením kategorie LC_CTYPE národního prostředí; viz setlocale pro další informace.Verze této funkce bez přípony _l používá aktuální národní prostředí pro toto chování závislé na národním prostředí. Verze s příponou _l je stejná s tím rozdílem, že používá předaný parametr národního prostředí.Další informace naleznete v tématu Národní prostředí.

Pokud je vstupní řetězec NULL, je vyvolána obslužná rutina neplatného parametru, jak je popsáno v Ověření parametru.Pokud smí provádění pokračovat, errno se nastaví na EINVAL a funkce vrátí _MBC_ILLEGAL.

Požadavky

Rutina	Požadované záhlaví	Volitelné záhlaví
_mbsbtype	<mbstring.h>	<mbctype.h>*
_mbsbtype_l	<mbstring.h>	<mbctype.h>*

* Pro konstanty manifestu používané jako vrácené hodnoty.

Další informace o kompatibilitě naleznete v tématu Kompatibilita.

Ekvivalent v rozhraní .NET Framework

Není k dispozici, ale viz System::Globalization::CultureInfo.

Viz také

Referenční dokumentace

Klasifikace bajtů

Sdílet prostřednictvím