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.