_mbbtombc, _mbbtombc_l

  • Artigo

Converte um caractere multibyte de um byte em um caractere multibyte de dois bytes 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 _mbbtombc(
   unsigned int c
);
unsigned int _mbbtombc_l(
   unsigned int c,
   _locale_t locale
);

Parâmetros

c
Caractere de um byte a ser convertido.

locale
Localidade a usar.

Valor retornado

Se _mbbtombc converter c com êxito, ele retornará um caractere multibyte, caso contrário, retornará c.

Comentários

A função _mbbtombc converte um determinado caractere multibyte de um byte em um caractere multibyte de dois bytes correspondente. Os caracteres devem estar dentro do intervalo 0x20 a 0x7E ou 0xA1 a 0xDF para serem convertidos.

O valor de saída é afetado pela configuração da categoria LC_CTYPE da localidade. Para obter mais informações, consulte setlocalee _wsetlocale. As versões desta função são idênticas, exceto pelo fato de _mbbtombc usa a localidade atual para esse comportamento dependente de localidade e _mbbtombc_l, em vez disso, usa o parâmetro de localidade passado. Para obter mais informações, consulte Localidade.

Em versões anteriores, _mbbtombc era chamado hantozen. Para códigos novos, use _mbbtombc.

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
_mbbtombc <mbstring.h>
_mbbtombc_l <mbstring.h>

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

Confira também

Conversão de dados
_mbctombb, _mbctombb_l