WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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