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

CKTIS / C++

std::uppercase — letras maiúsculas na saída numérica

std::uppercase é um manipulador de fluxo que seleciona letras maiúsculas na saída numérica formatada, como os dígitos hexadecimais A–F e o marcador de expoente E. Não transforma texto nem seleciona uma base numérica; a definição permanece ativa até ser alterada.

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

Sintaxe

#include <ios>
std::ios_base& std::uppercase(std::ios_base& str);
stream << std::uppercase;

std::uppercase, declarado em <ios>, é um manipulador de formatação de fluxo utilizado sem parênteses: stream << std::uppercase. Chama str.setf(std::ios_base::uppercase) e devolve o mesmo fluxo. std::uppercase é uma função, enquanto std::ios_base::uppercase é uma flag de formatação.

Na saída hexadecimal, seleciona os dígitos A–F em vez de a–f. Quando std::showbase ativa um prefixo, utiliza 0X em vez de 0x. Na saída de vírgula flutuante, seleciona, entre outras coisas, E em vez de e na notação científica e letras maiúsculas na notação hexadecimal.

O manipulador altera o uso de maiúsculas e minúsculas, não a base numérica. Os inteiros são escritos em hexadecimal quando o campo std::ios_base::basefield do fluxo está definido como std::ios_base::hex. Se o campo já tiver esse valor, não é preciso alterar nada; caso contrário, pode utilizar std::hex ou chamar stream.setf(std::ios_base::hex, std::ios_base::basefield). O manipulador não converte em maiúsculas as letras das cadeias de caracteres nem os caracteres escritos individualmente, e não altera os nomes dos valores booleanos escritos com std::boolalpha.

A flag pertence ao fluxo em causa e permanece definida para as operações seguintes, incluindo depois de uma mudança de linha. std::nouppercase desativa-a, mas não repõe outras definições, como std::hex ou std::showbase. Se uma função tiver de preservar a formatação anterior, guarde auto saved = stream.flags(); e restaure-a mais tarde com stream.flags(saved);.

Exemplos

#include <ios>
#include <iostream>
#include <locale>
#include <sstream>

int main() {
    std::ostringstream out;
    out.imbue(std::locale::classic());
    out << std::hex << std::showbase
        << std::uppercase << 48879 << ' ' << 26 << '\n'
        << std::nouppercase << 48879 << '\n';
    std::cout << out.str();
}

Resultado

0XBEEF 0X1A
0xbeef

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