tolower, _tolower, towlower, _tolower_l, _towlower_l

Converte um caractere em minúsculo.

Sintaxe

int tolower(
   int c
);
int _tolower(
   int c
);
int towlower(
   wint_t c
);
int _tolower_l(
   int c,
   _locale_t locale
);
int _towlower_l(
   wint_t c,
   _locale_t locale
);

Parâmetros

c
Caractere a ser convertido.

locale
Localidade a ser usada para conversão específica de localidade.

Retornar valor

Todas essas rotinas convertem uma cópia do c em minúsculas, se a conversão for possível e retorna o resultado. Não há nenhum valor de retorno reservado para indicar um erro.

Comentários

Cada uma dessas rotinas converte uma determinada letra maiúscula em uma letra minúscula, se for possível e relevante. A conversão de maiúsculas e minúsculas de towlower é específica da localidade. Somente caracteres relevantes à localidade atual são alterados quanto a maiúsculas e minúsculas. As funções sem o sufixo _l usam a localidade definida atualmente. As versões dessas funções que têm o sufixo _l usam a localidade como um parâmetro e a usam em vez da localidade definida atualmente. Para obter mais informações, consulte Localidade.

Para _tolower dar os resultados esperados, __isascii e isupper ambos devem retornar diferente de zero.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Mapeamentos de 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_l

Observação

_tolower_l e _towlower_l não têm dependência de localidade e não se destinam a serem chamados diretamente. Eles são fornecidos para uso interno por _totlower_l.

Requisitos

Rotina	Cabeçalho necessário
tolower	<ctype.h>
_tolower	<ctype.h>
towlower	<ctype.h> ou <wchar.h>

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

Exemplo

Veja o exemplo em to funções.

Confira também

Conversão de dados
Rotinas is e isw
Funções to
Localidade
Interpretação de sequências de caracteres multibyte