Share via

_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l

  • Статья

Преобразуют символы стандартов Japan Industry Standard (JIS) и Japan Microsoft (JMS) в разных направлениях.

Важно!

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

Синтаксис

unsigned int _mbcjistojms(
   unsigned int c
);
unsigned int _mbcjistojms_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbcjmstojis(
   unsigned int c
);
unsigned int _mbcjmstojis_l(
   unsigned int c,
   _locale_t locale
);

Параметры

c
Символ для преобразования.

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

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

Для японского языкового стандарта эти функции возвращают преобразованный символ или 0, если преобразование невозможно. Для других языковых стандартов эти функции возвращают переданный символ.

Замечания

Функция _mbcjistojms преобразует символ стандарта Japan Industry Standard (JIS) в символ Microsoft Kanji (Shift JIS). Символ преобразуется только в том случае, если байты свинца и тропы находятся в диапазоне 0x21 - 0x7E. Если старший или младший байт лежит вне этого диапазона, errno получает значение EILSEQ. Дополнительные сведения об этом и других кодах ошибок см. в разделе errno, _doserrnoи _sys_errlist_sys_nerr.

Функция _mbcjmstojis преобразует символ SHIFT JIS в символ JIS. Символ преобразуется только в том случае, если байт свинца находится в диапазоне 0x81 - 0x9F или 0xE0 - 0xFC, а байт тропы находится в диапазоне 0x40 - 0x7E или 0x80 - 0xFC. Некоторые точки кода в этом диапазоне не назначены символом и поэтому не могут быть преобразованы.

Параметр c должен иметь 16-разрядное значение, старшие 8 бит которого представляют старший байт преобразуемого символа, а младшие 8 бит — соответственно его младший байт.

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

В более ранних версиях и _mbcjmstojis были вызваны _mbcjistojmsjistojms и jmstojisсоответственно. _mbcjistojms_mbcjmstojis, _mbcjistojms_lи _mbcjmstojis_l вместо него следует использовать.

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

Требования

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

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

См. также

Преобразование данных
_ismbb Процедуры