Поделиться через

_mbsbtype, _mbsbtype_l

  • Статья

Возвращает тип байта в строке.

Внимание

Этот API нельзя использовать в приложениях, выполняемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.

Синтаксис

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

Параметры

mbstr
Адрес последовательности многобайтовых символов.

count
Смещение в байтах относительно заголовка строки.

locale
Используемый языковой стандарт.

Возвращаемое значение

_mbsbtype и _mbsbtype_l возвращает целочисленное значение, указывающее результат теста на указанном байте. Константы манифеста, представленные в приведенной ниже таблице, определены в файле Mbctype.h.

Возвращаемое значение Тип байта
_MBC_SINGLE (0) Однобайтовый символ. Например, на кодовой странице 932 возвращается значение 0, _mbsbtype если указанный байт находится в диапазоне 0x20 - 0x7E или 0xA1 - 0xDF.
_MBC_LEAD (1); Старший байт многобайтового символа. Например, на кодовой странице 932 возвращается значение 1, _mbsbtype если указанный байт находится в диапазоне 0x81 - 0x9F или 0xE0 - 0xFC.
_MBC_TRAIL (2); Младший байт многобайтового символа. Например, на кодовой странице 932 возвращается 2, _mbsbtype если указанный байт находится в диапазоне 0x40 - 0x7E или 0x80 - 0xFC.
_MBC_ILLEGAL (-1) NULL строка, недопустимый символ или байт null, найденный перед смещением count mbstrбайта.

Замечания

Функция _mbsbtype определяет тип байта в строке многобайтовых символов. Эта функция проверяет только байт со смещением count в mbstr, пропуская недопустимые символы перед указанным байтом.

Выходное значение зависит от параметра LC_CTYPE категории языкового стандарта. Дополнительные сведения см. в разделе setlocale. Версия этой функции без суффикса _l использует текущий языковой стандарт для данной функциональности, зависящей от языкового стандарта; версия с суффиксом _l идентична версии без суффикса, но использует переданный параметр языкового стандарта. Дополнительные сведения см. в разделе Locale.

Если входная строка имеет значение NULL, вызывается обработчик недопустимых параметров, как описано в разделе "Проверка параметров". Если выполнение может быть продолжено, для errno задается значение EINVAL , и функция возвращает значение _MBC_ILLEGAL.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Маршрут Обязательный заголовок Необязательный заголовок
_mbsbtype <mbstring.h> <mbctype.h>*
_mbsbtype_l <mbstring.h> <mbctype.h>*

* Для констант манифеста, используемых в качестве возвращаемых значений.

Дополнительные сведения о совместимости см. в разделе Совместимость.

См. также

Классификация байтов