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.