Compartilhar via

tolower, _tolower, towlower, _tolower_l, _towlower_l

  • Artigo

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

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 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