Partilhar via

_mbctombb, _mbctombb_l

  • Artigo

Converte um caractere multibyte de dois bytes em um caractere multibyte de um byte correspondente.

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 _mbctombb(
   unsigned int c
);
unsigned int _mbctombb_l(
   unsigned int c,
   _locale_t locale
);

Parâmetros

c
Caracteres multibyte a serem convertidos.

locale
Localidade a usar.

Valor retornado

Se for bem-sucedido, e _mbctombb_l retorna o caractere de byte único que corresponde a c; caso contrário, _mbctombb retorna c.

Comentários

As _mbctombb funções and _mbctombb_l convertem um determinado caractere multibyte em um caractere multibyte de byte único correspondente. Os caracteres devem corresponder aos caracteres de byte único dentro do intervalo 0x20 a 0x7E ou 0xA1 a 0xDF a ser convertido.

O valor de saída é afetado pela configuração da categoria LC_CTYPE da localidade. Para obter mais informações, consulte setlocale. A versão dessa função sem o sufixo _l usa a localidade atual desse comportamento dependente da localidade. A versão com o sufixo _l é idêntica, exceto por usar o parâmetro de localidade passado em seu lugar. Para obter mais informações, consulte Localidade.

Nas versões anteriores, _mbctombb era chamado zentohan. Use o _mbctombb em vez disso.

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
_mbctombb <mbstring.h>
_mbctombb_l <mbstring.h>

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

Confira também

Conversão de dados
_mbbtombc, _mbbtombc_l
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l
_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l