WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::uppercase — Großbuchstaben in der numerischen Ausgabe

std::uppercase ist ein Stream-Manipulator, der bei der formatierten numerischen Ausgabe Großbuchstaben auswählt, etwa die Hexadezimalziffern A–F und den Exponentenmarker E. Er wandelt keinen Text um und legt keine Zahlenbasis fest; die Einstellung bleibt aktiv, bis sie geändert wird.

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

Syntax

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

std::uppercase, deklariert in <ios>, ist ein Stream-Formatierungsmanipulator, der ohne Klammern verwendet wird: stream << std::uppercase. Er ruft str.setf(std::ios_base::uppercase) auf und gibt denselben Stream zurück. std::uppercase ist eine Funktion, während std::ios_base::uppercase ein Formatierungsflag ist.

Bei der hexadezimalen Ausgabe wählt er die Ziffern A–F statt a–f. Wenn std::showbase ein Präfix aktiviert, wird 0X statt 0x verwendet. Bei der Gleitkommaausgabe wählt er unter anderem E statt e in der wissenschaftlichen Schreibweise sowie Großbuchstaben in der hexadezimalen Schreibweise.

Der Manipulator ändert die Groß- und Kleinschreibung, nicht die Zahlenbasis. Ganzzahlen werden hexadezimal ausgegeben, wenn im Feld std::ios_base::basefield des Streams std::ios_base::hex gesetzt ist. Ist das bereits der Fall, ist keine Änderung nötig. Andernfalls können Sie std::hex verwenden oder stream.setf(std::ios_base::hex, std::ios_base::basefield) aufrufen. Der Manipulator wandelt weder Buchstaben in ausgegebenen Zeichenketten oder einzelnen Zeichen in Großbuchstaben um, noch ändert er die mit std::boolalpha ausgegebenen Bezeichnungen für boolesche Werte.

Das Flag gehört zum jeweiligen Stream und bleibt für nachfolgende Operationen gesetzt, auch über Zeilenumbrüche hinweg. std::nouppercase löscht es, setzt aber andere Einstellungen wie std::hex oder std::showbase nicht zurück. Wenn eine Funktion die vorherige Formatierung erhalten soll, speichern Sie auto saved = stream.flags(); und stellen Sie sie später mit stream.flags(saved); wieder her.

Beispiele

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

Ergebnis

0XBEEF 0X1A
0xbeef

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen