CKTIS / C++
std::ios::boolalpha — boolesche Werte als Text
Mit `setf` setzt du das Flag `std::ios::boolalpha`, damit der Stream `bool`-Werte mit den Namen seiner Locale statt in numerischer Form liest und schreibt.
Version: ISO C++23; implementation support may vary
Syntax
#include <iostream>
// Inside a function:
const auto previous = std::cout.setf(std::ios::boolalpha);
std::cout << true;
std::cout.flags(previous);std::ios::boolalpha ist ein Formatflag vom Typ std::ios_base::fmtflags, keine Funktion. std::ios ist ein Alias für std::basic_ios<char>. Sowohl das Flag als auch die Memberfunktion setf sind in std::ios_base deklariert und durch Vererbung verfügbar.
std::cout.setf(std::ios::boolalpha) setzt das Flag, ohne andere Flags zu verändern, und gibt den gesamten vorherigen Satz von Flags zurück. Die Überladung setf(flags, mask) ersetzt nur die von der Maske ausgewählten Bits. Der Aufruf selbst gibt nichts aus: Erst ein nachfolgendes << schreibt den bool-Wert. Mit der klassischen Locale erscheint true oder false statt der standardmäßigen Ausgabe 1 oder 0. Ganzzahlen wie das int-Literal 1 werden weiterhin als Zahlen ausgegeben.
Die Einstellung gilt nur für diesen Stream und bleibt nach der nächsten Ausgabe wirksam. Mit unsetf(std::ios::boolalpha) löschst du nur dieses Flag; mit flags(previous) stellst du alle gespeicherten Flags wieder her. Die freie Funktion std::boolalpha, verwendet wie in std::cout << std::boolalpha, setzt dasselbe Flag. Das Beispiel ruft stattdessen direkt setf auf.
Auf einem Eingabestream gleicht >> für bool bei gesetztem Flag die Eingabe mit den Namen aus der Locale-Facette std::numpunct dieses Streams ab. Findet die Auswertung keine eindeutige Übereinstimmung, setzt sie failbit. Das Setzen des Flags für std::cout verändert std::cin nicht.
Beispiele
#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
`std::locale::classic()` legt die Schreibweisen `true` und `false` fest. Das Programm gibt die Werte vor und nach dem Setzen des Flags und nach dem Wiederherstellen der vorherigen Flags aus.
Zugehörige Lektionen
- C++ · Lektion 5 · Fortgeschritten · Version: 3
Quellen
- Working Draft, Standard for Programming Language C++ (WG21 N4950)
- [iosfwd.syn] Header <iosfwd> synopsis
- [ios.overview] Class template basic_ios overview
- [ios.fmtflags] Type ios_base::fmtflags
- [fmtflags.state] State functions
- [basic.ios.cons] Constructors and initial stream state
- [fmtflags.manip] fmtflags manipulators
- [ostream.inserters.arithmetic] Arithmetic inserters
- [facet.num.put.virtuals] num_put virtual functions
- [facet.num.get.virtuals] num_get virtual functions
- [facet.numpunct.virtuals] numpunct virtual functions
- [locale.statics] Static members of locale