_mbcjistojms
, _mbcjistojms_l
, , _mbcjmstojis
, _mbcjmstojis_l
Convierte caracteres de JIS en caracteres de Japan Microsoft (JMS), y viceversa.
Importante
Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas en aplicaciones de la Plataforma universal de Windows.
Sintaxis
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
);
Parámetros
c
Carácter que se va a convertir.
locale
Configuración regional que se va a usar.
Valor devuelto
En la configuración regional japonesa, estas funciones devuelven un carácter convertidos, o 0 si la conversión no es posible. En una configuración regional no japonesa, estas funciones devuelven el carácter que se pasa.
Comentarios
La función _mbcjistojms
convierte un carácter de JIS en un carácter de Microsoft Kanji (Shift JIS). El carácter se convierte solo si los bytes inicial y final están en el intervalo 0x21 – 0x7E. Si el byte inicial o final está fuera de este intervalo, errno
se establece en EILSEQ
. Para obtener más información sobre este y otros códigos de error, vea errno
, _doserrno
, _sys_errlist
y _sys_nerr
.
La _mbcjmstojis
función convierte un carácter JIS mayús en un carácter JIS. El carácter se convierte solo si el byte inicial está en el intervalo 0x81 - 0x9F o 0xE0 - 0xFC y el byte final está en el intervalo 0x40 - 0x7E o 0x80 - 0xFC. Algunos puntos de código de ese intervalo no tienen asignado un carácter y, por tanto, no se pueden convertir.
El valor de c
debe ser un valor de 16 bits cuyos 8 bits superiores representen el byte inicial del carácter que se va a convertir y cuyos 8 bits inferiores representen el byte final.
El valor de salida se ve afectado por el valor de la categoría LC_CTYPE
de la configuración regional. Para obtener más información, vea setlocale
. Las versiones de estas funciones sin el sufijo _l
usan la configuración regional actual de su comportamiento dependiente de la configuración regional; las versiones con el sufijo _l
son idénticas salvo que usan el parámetro locale pasado en su lugar. Para obtener más información, vea Locale.
En versiones anteriores, _mbcjistojms
y _mbcjmstojis
se llamaron jistojms
a y jmstojis
, respectivamente. _mbcjistojms
En su lugar, , _mbcjistojms_l
_mbcjmstojis
y _mbcjmstojis_l
se deben usar.
De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.
Requisitos
Routine | Encabezado necesario |
---|---|
_mbcjistojms |
<mbstring.h> |
_mbcjistojms_l |
<mbstring.h> |
_mbcjmstojis |
<mbstring.h> |
_mbcjmstojis_l |
<mbstring.h> |
Para obtener más información sobre compatibilidad, consulte Compatibilidad.