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

CKTIS / C++

std::toupper — converter um carácter para maiúscula

std::toupper de <cctype> devolve o equivalente em maiúscula de um carácter segundo a localização C atual. O argumento tem de ser igual a EOF ou representável como unsigned char; o tipo devolvido é int.

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

Sintaxe

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

std::toupper de <cctype> tem a assinatura int std::toupper(int c). Devolve o carácter maiúsculo correspondente segundo a localização C atual, ou o argumento sem alterações quando não é possível efetuar uma conversão. Não modifica o argumento: atribui o resultado ou utiliza-o de outra forma.

O valor passado ao parâmetro do tipo int tem de ser igual a EOF ou representável como unsigned char. Qualquer outro valor causa comportamento indefinido. Como um char simples pode ser negativo, utiliza std::toupper(static_cast<unsigned char>(ch)) para uma variável do tipo char, desde que o valor obtido após a conversão explícita seja representável como int. Se int não puder representar todos os valores de unsigned char, verifica antes da chamada se o valor obtido cabe em int. Caso contrário, a conversão para int pode produzir um valor negativo diferente de EOF e causar comportamento indefinido. Se produzir EOF, a função recebe EOF em vez do valor do carácter. Se uma função de entrada devolver um valor do tipo int, verifica se é EOF antes de o converter para unsigned char.

O exemplo processa uma cadeia carácter a carácter e converte explicitamente o resultado int de volta para char. Pressupõe que cada valor obtido ao converter para unsigned char cabe em int. Com a localização inicial "C", o resultado esperado é HELLO, C++23! seguido de uma mudança de linha. Não se trata de um mecanismo geral de conversão entre maiúsculas e minúsculas em Unicode: processar bytes UTF-8 desta forma não é suficiente.

Não confundas esta função com a sobrecarga std::toupper(c, loc) de <locale>, que utiliza um objeto de localização fornecido explicitamente. As indicações acima sobre a conversão para unsigned char aplicam-se à função de um argumento de <cctype>.

Exemplos

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

int main() {
    std::string text = "Hello, C++23!";
    for (char& ch : text) {
        ch = static_cast<char>(
            std::toupper(static_cast<unsigned char>(ch)));
    }
    std::cout << text << '\n';
}

Resultado

HELLO, C++23!

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