_mbbtombc, _mbbtombc_l

Преобразует однобайтовый многобайтовый символ в соответствующий двухбайтовый многобайтовый символ.

Важно!

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

Синтаксис

unsigned int _mbbtombc(
   unsigned int c
);
unsigned int _mbbtombc_l(
   unsigned int c,
   _locale_t locale
);

Параметры

c
Однобайтовый символ, который необходимо преобразовать.

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

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

Если функция _mbbtombc успешно преобразовывает c, она возвращает многобайтовый символ; в противном случае она возвращает c.

Замечания

Функция _mbbtombc преобразовывает указанный однобайтовый многобайтовый символ в соответствующий двухбайтовый многобайтовый символ. Символы должны находиться в диапазоне 0x20 — 0x7E или 0xA1 — 0xDF для преобразования.

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

В более ранних версиях функция _mbbtombc называлась hantozen. Для нового кода используйте _mbbtombc.

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

Требования

Маршрут Обязательный заголовок
_mbbtombc <mbstring.h>
_mbbtombc_l <mbstring.h>

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

См. также

Преобразование данных
_mbctombb, _mbctombb_l