Partilhar via

_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l

  • Artigo

Converte entre caracteres Hiragana e Katakana.

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 _mbctohira(
   unsigned int c
);
unsigned int _mbctohira_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbctokata(
   unsigned int c
);
unsigned int _mbctokata_l(
   unsigned int c,
   _locale_t locale
);

Parâmetros

c
Caracteres multibyte a serem convertidos.

locale
Localidade a usar.

Valor retornado

Cada uma dessas funções retorna o caractere convertido c, se possível. Caso contrário, ela retorna o caractere c inalterado.

Comentários

As funções _mbctohira e _mbctokata testam um caractere c e, se possível, aplicam uma das conversões a seguir.

Rotinas Converte
_mbctohira, _mbctohira_l Katakana multibyte para Hiragana multibyte.
_mbctokata, _mbctokata_l Hiragana multibyte para Katakana multibyte.

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 são idênticas, exceto que aquelas que não têm o sufixo _l usam a localidade atual para esse comportamento dependente de localidade e as com um sufixo _l usam o parâmetro de localidade informado. Para obter mais informações, consulte Localidade.

Em versões anteriores, _mbctohira era chamado jtohira e _mbctokata era chamado jtokata. Para código novo, use os novos nomes.

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
_mbctohira <mbstring.h>
_mbctohira_l <mbstring.h>
_mbctokata <mbstring.h>
_mbctokata_l <mbstring.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Conversão de dados
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l
_mbctombb, _mbctombb_l