CKTIS / C++
`std::basic_ios::setf`: Formatierungsflags eines Streams setzen
`setf` ändert die Formatierungsflags eines Streams. Mit `std::ios::boolalpha` werden `bool`-Werte in der klassischen Locale als `true` und `false` ausgegeben.
Version: ISO C++23; implementation support may vary
Syntax
// Declared in std::ios_base (<ios>); inherited by std::basic_ios.
std::ios_base::fmtflags setf(std::ios_base::fmtflags flags);
std::ios_base::fmtflags setf(std::ios_base::fmtflags flags,
std::ios_base::fmtflags mask);std::basic_ios::setf ist eine geerbte Memberfunktion: Beide Überladungen sind in std::ios_base deklariert. std::ios ist ein Alias für std::basic_ios<char>. Daher bezeichnet std::ios::boolalpha dasselbe geerbte Flag wie std::ios_base::boolalpha.
setf(flags) setzt die angegebenen Bits und lässt die übrigen unverändert. setf(flags, mask) ersetzt nur die durch mask ausgewählten Bits durch die entsprechenden Bits aus flags. Mit out.setf(std::ios_base::hex, std::ios_base::basefield) wechselst du die Zahlenbasis für Ganzzahlen, ohne das bisherige Basisflag gesetzt zu lassen. Beide Überladungen geben den vollständigen vorherigen Flagsatz als std::ios_base::fmtflags zurück, keinen Fehlercode und keine Stream-Referenz.
std::cout.setf(std::ios::boolalpha) gibt nichts aus. Erst der Stream-Ausgabeoperator << berücksichtigt das Flag bei der Ausgabe eines bool-Werts. In der klassischen Locale erscheint true oder false statt der üblichen 1 oder 0; eine andere Locale kann andere Namen verwenden. std::cout << std::boolalpha setzt dasselbe Flag über einen Manipulator, der keine Memberfunktion ist. Das Beispiel verwendet ihn nicht. Die Ausgabe der Ganzzahlen 1 und 0 bleibt unverändert.
Das Flag bleibt nach << in diesem Stream gesetzt. Mit out.unsetf(std::ios::boolalpha) löschst du nur dieses Flag, mit out.flags(previous) stellst du den gesamten gespeicherten Flagsatz wieder her.
Beispiele
#include <ios>
#include <iostream>
#include <locale>
int main() {
std::cout.imbue(std::locale::classic());
std::cout << true << ' ' << false << '\n';
const auto previous = std::cout.setf(std::ios::boolalpha);
std::cout << true << ' ' << false << '\n';
std::cout.flags(previous);
std::cout << true << ' ' << false << '\n';
}Ergebnis
1 0 true false 1 0
Das Programm wählt ausdrücklich `std::locale::classic()`. Erwartet werden die Zeilen `1 0`, `true false` und nach dem Wiederherstellen der Flags erneut `1 0`.
Zugehörige Lektionen
- C++ · Lektion 5 · Fortgeschritten · Version: 3
Quellen
- C++ working draft — ios_base state functions [fmtflags.state]
- C++ working draft — Class template basic_ios overview [ios.overview]
- C++ working draft — Header <iosfwd> synopsis [iosfwd.syn]
- C++ working draft — fmtflags manipulators [fmtflags.manip]
- C++ working draft — Arithmetic inserters [ostream.inserters.arithmetic]
- C++ working draft — num_put virtual functions [facet.num.put.virtuals]
- C++ working draft — Class template numpunct [locale.numpunct]