WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::boolalpha — bool-Werte in Streams als Text darstellen

std::boolalpha aktiviert die textuelle Ausgabe und Eingabe von bool-Werten in einem bestimmten Stream. In der klassischen Locale lauten die Namen true und false. Die Einstellung bleibt aktiv, bis sie geändert wird.

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

Syntax

std::ios_base& std::boolalpha(std::ios_base& str);
out << std::boolalpha << value;
in >> std::boolalpha >> value;

std::boolalpha ist ein in <ios> deklarierter Stream-Manipulator. Verwenden Sie out << std::boolalpha, um die Ausgabe einzustellen, oder in >> std::boolalpha für die Eingabe. Die Funktion setzt das Flag std::ios_base::boolalpha und gibt eine Referenz auf denselben Stream zurück; sie schreibt oder liest selbst keinen Wert.

Ist das Flag aktiviert, werden Werte des Typs bool anhand der Namen aus der Locale des Streams ausgegeben und erkannt. Bei std::locale::classic() sind dies true und false. Gehen Sie nicht davon aus, dass jede Locale dieselben Namen verwendet. Der Manipulator wandelt keine Ganzzahlen in Wörter um.

Die Einstellung gilt für den jeweiligen Stream und bleibt auch nach der nächsten Operation aktiv. std::noboolalpha löscht das Flag, sodass bool-Werte wieder numerisch ausgegeben und eingelesen werden. Die übrigen Formatierungsflags bleiben unverändert. Mit der klassischen Locale und aktiviertem std::ios_base::showpos wird true beispielsweise im Dezimalformat als +1 ausgegeben. Eine Änderung des Formats von std::cout ändert nicht das Format eines separaten Eingabestreams.

Bei der Eingabe führt Text, der nicht zum erwarteten Namen passt, dazu, dass failbit gesetzt wird. Prüfen Sie das Ergebnis der Operation, zum Beispiel mit if (!(input >> std::boolalpha >> value)). Das Beispiel verwendet für beide Streams die klassische Locale, liest zwei Werte und zeigt anschließend die textuelle und numerische Ausgabe.

Beispiele

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

int main() {
    std::cout.imbue(std::locale::classic());
    std::istringstream input("true false");
    input.imbue(std::locale::classic());

    bool first = false;
    bool second = true;
    if (!(input >> std::boolalpha >> first >> second)) {
        return 1;
    }

    std::cout << std::boolalpha << first << ' ' << second << '\n';
    std::cout << std::noboolalpha << first << ' ' << second << '\n';
}

Ergebnis

true false
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.

Quellen