_mbsbtype, _mbsbtype_l

Статья
06/09/2015

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

Важно!

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

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 _mbsbtype возвращает 0, если указанный байт в диапазоне 0x20 - 0x7E или 0xA1 - 0xDF.
_MBC_LEAD (1)	Старший байт многобайтового символа. Например, в кодовой странице 932 _mbsbtype возвращает 1, если указанный байт в диапазоне 0x81 – 0x9F или 0xE0 – 0xFC.
_MBC_TRAIL (2)	Конечный байт многобайтового символа. Например, в кодовой странице 932 _mbsbtype возвращает 2, если указанный байт в диапазоне 0x40 – 0x7E или 0x80 – 0xFC.
_MBC_ILLEGAL (–1)	Пустая строка (NULL), недопустимый символ или пустой байт (NULL) найдены перед байтом со смещением count в mbstr.

Заметки

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

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

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

Требования

Подпрограмма	Обязательный заголовок	Необязательный заголовок
_mbsbtype	<mbstring.h>	<mbctype.h>*
_mbsbtype_l	<mbstring.h>	<mbctype.h>*

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

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

Эквивалент в .NET Framework

Неприменимо, но см. раздел System::Globalization::CultureInfo.

См. также

Ссылки

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

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