Udostępnij przez

_mbsbtype, _mbsbtype_l

  • Artykuł

Zwraca typ bajtu w ciągu.

Ważne

Tego interfejsu API nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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 z nagłówka ciągu.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

_mbsbtype funkcja zwraca _mbsbtype_l wartość całkowitą wskazującą wynik testu w określonym bajtzie. Stałe manifestu w poniższej tabeli są zdefiniowane w mbctype.h.

Wartość zwracana Typ bajtu
_MBC_SINGLE (0) Znak jednobajtowy. Na przykład na stronie kodu 932 zwraca wartość 0, _mbsbtype jeśli określony bajt znajduje się w zakresie 0x20 — 0x7E lub 0xA1 — 0xDF.
_MBC_LEAD (1) Bajt główny znaku wielobajtowego. Na przykład na stronie kodu 932 zwraca wartość 1, _mbsbtype jeśli określony bajt znajduje się w zakresie 0x81 — 0x9F lub 0xE0 — 0xFC.
_MBC_TRAIL (2) Końcowy bajt znaku wielobajtowego. Na przykład na stronie kodowej 932 zwraca wartość 2, _mbsbtype jeśli określony bajt znajduje się w zakresie 0x40 — 0x7E lub 0x80 — 0xFC.
_MBC_ILLEGAL (-1) NULL ciąg, nieprawidłowy znak lub bajt o wartości null znaleziony przed bajtem z przesunięciem count w pliku mbstr.

Uwagi

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

Na wartość wyjściową ma wpływ ustawienie LC_CTYPE ustawienia kategorii ustawień regionalnych. W celu uzyskania więcej informacji, zobacz następujący temat: setlocale. Wersja tej funkcji bez sufiksu _l używa bieżących ustawień regionalnych dla tego zachowania zależnego od ustawień regionalnych; wersja z _l sufiksem jest identyczna, z tą różnicą, że używa parametru ustawień regionalnych przekazanych zamiast. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Jeśli ciąg wejściowy to NULL, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie jest dozwolone do kontynuowania, jest ustawione na EINVAL , errno a funkcja zwraca wartość _MBC_ILLEGAL.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Procedura Wymagany nagłówek Opcjonalny nagłówek
_mbsbtype <mbstring.h> <mbctype.h>*
_mbsbtype_l <mbstring.h> <mbctype.h>*

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

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Zobacz też

Klasyfikacja bajtów