Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::tolower — conversão para minúsculas

std::tolower de <cctype> converte um carácter para minúscula de acordo com a locale C atual. Para um valor do tipo char, converta-o primeiro para unsigned char e só chame a função se o valor obtido for representável como int.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <cctype>
int std::tolower(int c);

std::tolower de <cctype> recebe um int e devolve como int o equivalente em minúscula ou o mesmo valor, caso não seja possível fazer a conversão. Não modifica o argumento; guarde o resultado.

O argumento tem de ser igual a EOF ou ter um valor representável como unsigned char. Outros valores provocam comportamento indefinido. Um char simples pode ser negativo, pelo que deve primeiro converter c com static_cast<unsigned char>(c). A chamada std::tolower(static_cast<unsigned char>(c)) é válida para qualquer valor do tipo char se UCHAR_MAX <= INT_MAX (ambas as constantes estão disponíveis em <climits>). Caso contrário, verifique antes da chamada se o valor u obtido, do tipo unsigned char, satisfaz u <= INT_MAX. Se não satisfizer a condição, trate esse valor sem chamar a função. A conversão de um valor fora do intervalo de int para o tipo do parâmetro pode produzir um valor negativo: se for diferente de EOF, o comportamento é indefinido; se for igual a EOF, a função não o trata como um carácter. Verifique se um valor de fluxo do tipo int é EOF antes de o converter para unsigned char.

O resultado depende da locale C atual. Não se trata de conversão entre maiúsculas e minúsculas Unicode nem de descodificação UTF-8. A sobrecarga std::tolower(c, loc) de <locale> é distinta: usa std::ctype para o objeto locale fornecido.

O exemplo processa uma cadeia carácter a carácter e guarda cada resultado como char. Não verifica o intervalo: pressupõe que os valores obtidos após a conversão para unsigned char são representáveis como int. Não altera a locale C inicial. Não altere as definições globais através de std::setlocale enquanto esta função é chamada, sem sincronização.

Exemplos

#include <cctype>
#include <iostream>
#include <string>

int main() {
    std::string text = "Hello, CPP23!";
    for (char& c : text) {
        c = static_cast<char>(std::tolower(static_cast<unsigned char>(c)));
    }
    std::cout << text << '\n';
}

Resultado

hello, cpp23!

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes