_mbsbtype, _mbsbtype_l

Artykuł
06/09/2015

Zwraca wartość typu bajtu wewnątrz ciągu.

Ważne
Tego API nie można używać w aplikacjach korzystających ze środowiska wykonawczego Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /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
Adres sekwencji znaków wielobajtowych.
count
Przesunięcie bajtu od czoła ciągu.
locale
Ustawienia regionalne do użycia.

Wartość zwracana

_mbsbtype i _mbsbtype_lzwracają wartość całkowitą, wskazując wynik testu na określonym bajcie.Stałe manifestu w poniższej tabeli są zdefiniowane w Mbctype.h.

Wartość zwrócona	Typu bajtu
_MBC_SINGLE (0)	Znak jednobajtowy.Na przykład, na stronie kodowej 932, _mbsbtype zwraca wartość 0, jeśli określony bajt znajduje się w zakresie 0x20 – 0x7E lub 0xA1 – 0xDF.
_MBC_LEAD (1)	Bajt wiodący znaku wielobajtowego.Na przykład, na stronie kodowej 932, _mbsbtype zwraca wartość 1, jeśli określony bajt znajduje się w zakresie 0x81 – 0x9F lub 0xE0 – 0xFC.
_MBC_TRAIL (2)	Bajt wiodący znaku wielobajtowego.Na przykład, na stronie kodowej 932, _mbsbtype zwraca wartość 2, jeśli określony bajt znajduje się w zakresie 0x40 – 0x7E lub 0x80 – 0xFC
_MBC_ILLEGAL (–1)	Ciąg NULL, nieprawidłowy znak lub bajt NULL znalezione przed bajtem przesunięcia count w mbstr.

Uwagi

_mbsbtype funkcja określa typ bajtu w ciągu znaków wielobajtowych.Funkcja sprawdza tylko bajt przesunięcia count w mbstr, ignorując nieprawidłowe znaków przed określonym bajtem.

Wartość wyjściowa jest zależna od konfiguracji ustawień kategorii LC_CTYPE ustawień regionalnych; zobacz setlocale, aby uzyskać więcej informacji.Wersja tej funkcji, która nie ma przyrostka _l używa bieżących ustawień regionalnych dla wszelkich zachowań zależnych od ustawień lokalnych; wersja, która ma przyrostek _l jest identyczna, z tą różnicą, że w zamian korzysta z przekazanego parametru ustawień regionalnych.Aby uzyskać więcej informacji, zobacz Regionalne.

Jeśli ciąg wartości wejściowych ma wartość NULL, zostanie wywołana procedura obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, errno jest ustawione jako EINVAL, a funkcja zwraca _MBC_ILLEGAL.

Wymagania

Procedura	Wymagany nagłówek	Opcjonalny nagłówek
_mbsbtype	<mbCiąg.h>	<mbctype.h>*
_mbsbtype_l	<mbCiąg.h>	<mbctype.h>*

* Dla stałych manifestu używanych jako wartości zwracane.

Aby uzyskać więcej informacji na temat zgodności – zobacz: Zgodność.

Odpowiednik w programie .NET Framework

Nie dotyczy, ale zobacz System::Globalization::CultureInfo.

Zobacz też

Informacje

Klasyfikacja bajtów

Udostępnij za pośrednictwem