Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::uppercase — lettere maiuscole nell’output numerico

std::uppercase è un manipolatore di stream che seleziona le lettere maiuscole nell’output numerico formattato, ad esempio le cifre esadecimali A–F e il simbolo dell’esponente E. Non trasforma il testo né seleziona una base numerica; l’impostazione resta attiva finché non viene modificata.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

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

std::uppercase, dichiarato in <ios>, è un manipolatore di formattazione dello stream che si usa senza parentesi: stream << std::uppercase. Chiama str.setf(std::ios_base::uppercase) e restituisce lo stesso stream. std::uppercase è una funzione, mentre std::ios_base::uppercase è un flag di formattazione.

Nell’output esadecimale seleziona le cifre A–F invece di a–f. Quando std::showbase abilita un prefisso, usa 0X invece di 0x. Nell’output in virgola mobile seleziona, tra le altre cose, E invece di e nella notazione scientifica e lettere maiuscole nella notazione esadecimale.

Il manipolatore agisce sull’uso di maiuscole e minuscole, non sulla base numerica. Gli interi vengono scritti in esadecimale quando il campo std::ios_base::basefield dello stream è impostato su std::ios_base::hex. Se il campo ha già quel valore, non occorre modificarlo; altrimenti si può usare std::hex o chiamare stream.setf(std::ios_base::hex, std::ios_base::basefield). Il manipolatore non converte in maiuscolo le lettere delle stringhe o i singoli caratteri scritti, né cambia i nomi dei valori booleani scritti con std::boolalpha.

Il flag appartiene allo stream specifico e resta impostato per le operazioni successive, anche dopo un’interruzione di riga. std::nouppercase lo disattiva, ma non azzera altre impostazioni come std::hex o std::showbase. Se una funzione deve mantenere la formattazione precedente, salvi auto saved = stream.flags(); e la ripristini in seguito con stream.flags(saved);.

Esempi

#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();
}

Risultato

0XBEEF 0X1A
0xbeef

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti