_mbctombb, _mbctombb_l

Artigo
06/09/2015

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

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

Parâmetros

c
Caractere de multibyte a ser convertido.
locale
Localidade a ser usada.

Valor de retorno

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

Comentários

As funções _mbctombb e _mbctombb_lconverte um caractere multibyte especificado em um caractere multibyte de byte único correspondente. Os caráteres devem corresponder a caráteres de byte único dentro do intervalo 0x20 – 0x7E ou 0xA1 – 0xDF a ser convertido.

O valor de saída é afetado pela configuração da categoria LC_CTYPE de localidade. Para obter mais informações, consulte setlocale. A versão dessa função sem o sufixo _l usa a localidade atual para esse comportamento dependente da localidade; a versão com o sufixo _l é idêntica, exceto pelo fato de que ela usa o parâmetro de localidade informado. Para obter mais informações, consulte Localidade.

Em versões anteriores, _mbctombb era chamado de zentohan. Use _mbctombb em vez disso.