Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Возвращает тип байта в строке.
Внимание
Этот 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>* |
* Для констант манифеста, используемых в качестве возвращаемых значений.
Дополнительные сведения о совместимости см. в разделе Совместимость.