_mbcjistojms
, _mbcjistojms_l
, _mbcjmstojis
, _mbcjmstojis_l
Converte entre caracteres JIS (Japan Industry Standard) e JMS (Japan Microsoft).
Importante
Esta API não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.
Sintaxe
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
Caractere a ser convertido.
locale
Localidade a usar.
Valor retornado
No Japão, essas funções retornarão um caractere convertido ou retornam 0 se nenhuma conversão for possível. Em uma localidade não japonesa, essas funções retornam o caractere passado.
Comentários
A função _mbcjistojms
converte um caractere JIS (Japan Industry Standard) em um caractere de Kanji Microsoft (Shift JIS). O caractere será convertido somente se os bytes inicial e final estiverem no intervalo 0x21 a 0x7E. Se o byte inicial ou final estiver fora desse intervalo, errno
será definido como EILSEQ
. Para obter mais informações sobre esse e outros códigos de erro, consulte errno
, _doserrno
, _sys_errlist
e _sys_nerr
.
A _mbcjmstojis
função converte um caractere Shift JIS em um caractere JIS. O caractere será convertido somente se o byte inicial estiver no intervalo 0x81 a 0x9F ou 0xE0 a 0xFC e o byte final estiver no intervalo 0x40 a 0x7E ou 0x80 a 0xFC. Alguns pontos de código nesse intervalo não têm um caractere atribuído e, portanto, não podem ser convertidos.
O valor c
deve ser um valor de 16 bits cujos 8 bits superiores representam o byte inicial do caractere a ser convertido e cujos 8 bits inferiores representem o byte final.
O valor de saída é afetado pela configuração da categoria LC_CTYPE
da localidade. Para obter mais informações, consulte setlocale
. As versões dessas funções sem o sufixo _l
usam a localidade atual desse comportamento dependente da localidade. As versões com o sufixo _l
são idênticas, exceto por usarem o parâmetro de localidade passado em seu lugar. Para obter mais informações, consulte Localidade.
Em versões anteriores, _mbcjistojms
e _mbcjmstojis
eram chamados de jistojms
e jmstojis
, respectivamente. _mbcjistojms
, _mbcjistojms_l
e _mbcjmstojis
_mbcjmstojis_l
deve ser usado em seu lugar.
Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.
Requisitos
Rotina | Cabeçalho necessário |
---|---|
_mbcjistojms |
<mbstring.h> |
_mbcjistojms_l |
<mbstring.h> |
_mbcjmstojis |
<mbstring.h> |
_mbcjmstojis_l |
<mbstring.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.