_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
Converte entre caracteres de padrão da indústria (JIS) do Japão e caracteres da Microsoft do Japão (JMS).
Importante
Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.
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.local
Localidade a ser usada.
Valor de retorno
Na localidade japonesa, essas funções retornam um caractere convertido ou retornam 0 se não for possível fazer nenhuma conversão. Em uma localidade não japonesa, essas funções retornam os caracteres transmitidos.
Comentários
A função _mbcjistojms converte um caractere JIS (padrão da indústria do Japão) em um caractere SHIFT JIS (Microsoft Kanji). O caractere é convertido somente se os byte iniciais e finais estiverem no intervalo 0x21 – 0x7E. Se o byte de ligação ou de experimentação estiver fora desse intervalo, errno é 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 função _mbcjmstojisconverte um caractere Shift JIS em um caractere JIS. O caractere é convertido somente se o byte inicial estiver no intervalo 0x81 – 0x9F ou 0xE0 – 0xFC e o byte final estiver no intervalo 0x40 – 0x7E ou 0x80 – 0xFC. Observe que alguns pontos de código no 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 representam o byte final.
O valor de saída é afetado pela configuração da categoria LC_CTYPE de localidade. Para obter mais informações, consulte setlocale. As versões dessas funções sem o sufixo _l usam a localidade atual para esse comportamento dependente da localidade; as versões com o sufixo _l são idênticas, exceto que elas usam o parâmetro de localidade informado. Para obter mais informações, consulte Localidade.
Em versões anteriores, _mbcjistojms e _mbcjmstojis eram chamadosjistojms e jmstojis, respectivamente. _mbcjistojms,_mbcjistojms_l,_mbcjmstojis e _mbcjmstojis_l devem ser usados no lugar.
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_mbcjistojms |
<mbstring.h> |
_mbcjistojms_l |
<mbstring.h> |
_mbcjmstojis |
<mbstring.h> |
_mbcjmstojis_l |
<mbstring.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade.
Equivalência do .NET Framework
Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.