_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Artigo
06/09/2015

Testa e converte o caso de um caractere multibyte.

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 _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
Caractere de multibyte a ser convertido.
locale
Localidade a ser usada.

Valor de retorno

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

Comentários

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

Rotinas	Converte
_mbctolower,_mbctolower_l	Caractere maiúsculo para caractere minúsculo.
_mbctoupper,_mbctoupper_l	Caractere minúsculo para caractere maiúsculo.

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, _mbctolower era chamado dejtolower, e _mbctoupper era chamado de jtoupper. Para o novo código, use os nomes novos em vez disso.

Mapeamentos da rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_totlower	tolower	_mbctolower	towlower
_totlower_l	_tolower_l	_mbctolower_l	_towlower_t
_totupper	toupper	_mbctoupper	towupper
_totupper_l	toupper_l	_mbctoupper_l	_towupper_l