_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Testa e converte o formato de maiúsculas e minúsculas de um caractere multibyte.

Sintaxe

unsigned int _mbctolower(
   unsigned int c
);
unsigned int _mbctolower_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbctoupper(
   unsigned int c
);
unsigned int _mbctoupper_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 testam um caractere c e, se possível, aplicam uma das conversões a seguir.

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, _mbctolower era chamado jtolowerde , e _mbctoupper era chamado de jtoupper. 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.

Mapeamentos de rotina de texto genérico

Requisitos

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
_mbctombb, _mbctombb_l