Sdílet prostřednictvím

_mbsbtype, _mbsbtype_l

  • Článek

Vrátí typ bajtu v řetězci.

Důležité

Toto rozhraní API nelze použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

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 posloupnosti vícebajtových znaků

count
Posun bajtu od hlavy řetězce

locale
Národní prostředí, které se má použít.

Vrácená hodnota

_mbsbtype a _mbsbtype_l vrá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 Mbctype.h.

Vrácená hodnota Typ bajtu
_MBC_SINGLE (0) Jednobajtů. Například na znakové stránce 932 vrátí hodnotu 0, _mbsbtype pokud zadaný bajt spadá do rozsahu 0x20 – 0x7E nebo 0xA1 – 0xDF.
_MBC_LEAD (1) Hlavní bajt vícebajtového znaku. Například na znakové stránce 932 vrátí hodnotu 1, _mbsbtype pokud zadaný bajt spadá do rozsahu 0x81 – 0x9F nebo 0xE0 – 0xFC.
_MBC_TRAIL (2) Koncový bajt vícebajtového znaku. Například na znakové stránce 932 vrátí hodnotu 2, _mbsbtype pokud zadaný bajt spadá do rozsahu 0x40 – 0x7E nebo 0x80 – 0xFC.
_MBC_ILLEGAL (-1) NULL řetězec, neplatný znak nebo bajt null nalezen před bajtem při posunu count v mbstr.

Poznámky

Funkce _mbsbtype určuje typ bajtu ve vícebajtovém řetězci znaků. Funkce zkoumá pouze bajt na posunu count v mbstr, ignoruje neplatné znaky před zadaný bajt.

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

Pokud je NULLvstupní řetězec , je vyvolána neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je povoleno pokračovat provádění, errno je nastavena na EINVAL a funkce vrátí _MBC_ILLEGAL.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Rutina Požadovaný hlavičkový soubor Volitelné záhlaví
_mbsbtype <mbstring.h> <mbctype.h>*
_mbsbtype_l <mbstring.h> <mbctype.h>*

* Pro konstanty manifestu používané jako návratové hodnoty.

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

Viz také

Klasifikace bajtů