KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen