KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::ios_base: opmaakflags en precisie

std::ios_base slaat de opmaakstatus van een stream op. Leer hoe de setf-overloads verschillen, wat precision betekent en hoe je fixed en boolalpha inschakelt terwijl je de instellingen bewaart om ze later te herstellen.

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

Syntax

std::ios_base::fmtflags setf(std::ios_base::fmtflags fmtfl);
std::ios_base::fmtflags setf(std::ios_base::fmtflags fmtfl, std::ios_base::fmtflags mask);
std::streamsize precision() const;
std::streamsize precision(std::streamsize prec);

stream.setf(std::ios_base::fixed, std::ios_base::floatfield);
stream.precision(2);
stream.setf(std::ios_base::boolalpha);

std::ios_base slaat de opmaakinstellingen van een afzonderlijke stream op. std::ios_base::setf en std::ios_base::precision zijn memberfuncties; std::ios_base::fixed en std::ios_base::boolalpha zijn fmtflags-flags, niet de manipulators std::fixed en std::boolalpha. Instellingen blijven actief totdat ze opnieuw worden gewijzigd.

setf(fmtfl) voegt de opgegeven bits toe zonder andere te wissen. setf(fmtfl, mask) wist eerst de door mask geselecteerde bits en stelt daarna fmtfl & mask in. Beide overloads geven de vorige volledige verzameling flags terug. Gebruik voor vaste-kommanotatie setf(std::ios_base::fixed, std::ios_base::floatfield): alleen fixed toevoegen wist scientific niet; als beide bits zijn ingesteld, wordt hexadecimale drijvendekommanotatie geselecteerd.

precision() leest de precisie uit, terwijl precision(n) deze instelt en de vorige waarde teruggeeft. In de modus fixed geeft de precisie het aantal cijfers na het decimaalteken aan; in de standaardmodus voor drijvende-kommagetallen geeft ze het aantal significante cijfers aan. De opgeslagen numerieke waarde verandert hierdoor niet. boolalpha schakelt tekstuele invoer en uitvoer van bool in; de namen zijn afhankelijk van de locale. Met std::locale::classic() zijn dat true en false, in plaats van de numerieke uitvoer 1 en 0.

Het voorbeeld gebruikt een lokale stream met std::locale::classic() om het decimaalteken en de booleaanse namen vast te leggen. Het slaat de flags en precisie op en herstelt ze daarna afzonderlijk met flags(savedFlags) en precision(savedPrecision). Zorg bij een gedeelde stream ook voor herstel als er een uitzondering optreedt, bijvoorbeeld met een RAII-guard.

Voorbeelden

#include <iostream>
#include <locale>
#include <sstream>

int main() {
    std::ostringstream out;
    out.imbue(std::locale::classic());

    const auto savedFlags = out.setf(
        std::ios_base::fixed, std::ios_base::floatfield);
    const auto savedPrecision = out.precision(2);
    out.setf(std::ios_base::boolalpha);

    out << 12.5 << ' ' << true << ' ' << false << '\n';

    out.flags(savedFlags);
    out.precision(savedPrecision);
    out << 12.5 << ' ' << true << ' ' << false << '\n';

    std::cout << out.str();
}

Resultaat

12.50 true false
12.5 1 0

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