CKTIS / C++
std::ios_base: Formatierungsflags und Präzision
std::ios_base speichert den Formatierungszustand eines Streams. Erfahre, worin sich die setf-Überladungen unterscheiden, was precision bedeutet und wie du fixed und boolalpha aktivierst und die Einstellungen anschließend wiederherstellst.
Version: 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 speichert die Formatierungseinstellungen eines einzelnen Streams. std::ios_base::setf und std::ios_base::precision sind Memberfunktionen; std::ios_base::fixed und std::ios_base::boolalpha sind fmtflags-Flags und nicht die Manipulatoren std::fixed und std::boolalpha. Die Einstellungen bleiben aktiv, bis sie erneut geändert werden.
setf(fmtfl) fügt die angegebenen Bits hinzu, ohne andere zu löschen. setf(fmtfl, mask) löscht zuerst die durch mask ausgewählten Bits und setzt dann fmtfl & mask. Beide Überladungen geben den vorherigen vollständigen Flagsatz zurück. Für die Festkommaschreibweise verwendest du setf(std::ios_base::fixed, std::ios_base::floatfield): Das bloße Hinzufügen von fixed löscht scientific nicht; sind beide Bits gesetzt, wird die hexadezimale Gleitkommaschreibweise gewählt.
precision() liest die Präzision aus, während precision(n) sie setzt und den vorherigen Wert zurückgibt. Im Modus fixed gibt die Präzision die Anzahl der Ziffern nach dem Dezimaltrennzeichen an; im standardmäßigen Gleitkommamodus gibt sie die Anzahl signifikanter Ziffern an. Der gespeicherte Zahlenwert wird dadurch nicht geändert. boolalpha aktiviert die textuelle Ausgabe und Eingabe von bool; die Namen hängen von der Locale ab. Mit std::locale::classic() lauten sie true und false statt der numerischen Ausgabe 1 und 0.
Das Beispiel verwendet einen lokalen Stream mit std::locale::classic(), damit Dezimaltrennzeichen und boolesche Namen festgelegt sind. Es speichert Flags und Präzision und stellt sie anschließend getrennt mit flags(savedFlags) und precision(savedPrecision) wieder her. Bei einem gemeinsam genutzten Stream solltest du auch für den Fall einer Ausnahme die Wiederherstellung sicherstellen, zum Beispiel mit einem RAII-Guard.
Beispiele
#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();
}
Ergebnis
12.50 true false 12.5 1 0
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.