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.

Valor retornado

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 retornado 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 ambos isupper devem retornar diferente de zero.

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.

Exemplo

Veja o exemplo em funções to.

Confira também

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