CKTIS / C++
std::uppercase — hoofdletters in numerieke uitvoer
std::uppercase is een streammanipulator die hoofdletters kiest in geformatteerde numerieke uitvoer, zoals de hexadecimale cijfers A–F en de exponentmarkering E. De manipulator verandert geen tekst en kiest geen getallenbasis; de instelling blijft actief totdat die wordt gewijzigd.
Versie: 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, gedeclareerd in <ios>, is een streamopmaakmanipulator die zonder haakjes wordt gebruikt: stream << std::uppercase. De manipulator roept str.setf(std::ios_base::uppercase) aan en retourneert dezelfde stream. std::uppercase is een functie, terwijl std::ios_base::uppercase een opmaakvlag is.
Bij hexadecimale uitvoer kiest de manipulator de cijfers A–F in plaats van a–f. Als std::showbase een voorvoegsel inschakelt, wordt 0X gebruikt in plaats van 0x. Bij uitvoer met drijvende komma kiest de manipulator onder meer E in plaats van e in wetenschappelijke notatie en hoofdletters in hexadecimale notatie.
De manipulator bepaalt het gebruik van hoofdletters, niet de getallenbasis. Gehele getallen worden hexadecimaal uitgevoerd als het veld std::ios_base::basefield van de stream is ingesteld op std::ios_base::hex. Heeft het veld die waarde al, dan hoeft er niets te veranderen. Anders kun je std::hex gebruiken of stream.setf(std::ios_base::hex, std::ios_base::basefield) aanroepen. De manipulator zet letters in uitgevoerde tekenreeksen of losse tekens niet om in hoofdletters en verandert evenmin de namen van booleaanse waarden die met std::boolalpha worden geschreven.
De vlag hoort bij de betreffende stream en blijft ingesteld voor volgende bewerkingen, ook na een regeleinde. std::nouppercase wist de vlag, maar zet andere instellingen zoals std::hex of std::showbase niet terug. Als een functie eerdere opmaak moet behouden, sla dan auto saved = stream.flags(); op en herstel de opmaak later met stream.flags(saved);.
Voorbeelden
#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();
}
Resultaat
0XBEEF 0X1A 0xbeef
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.