Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::boolalpha — tekstowy zapis wartości bool w strumieniach

std::boolalpha włącza tekstowy zapis i odczyt wartości bool w danym strumieniu. W klasycznych ustawieniach regionalnych nazwami tych wartości są true i false. Ustawienie pozostaje aktywne do jego zmiany.

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

Składnia

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

std::boolalpha to manipulator strumienia, deklarowany w <ios>. Użyj out << std::boolalpha do formatowania wyjścia albo in >> std::boolalpha do odczytu. Funkcja ustawia flagę std::ios_base::boolalpha i zwraca referencję do tego samego strumienia; sama nie zapisuje ani nie odczytuje wartości.

Przy włączonej fladze wartości typu bool są zapisywane i rozpoznawane za pomocą nazw z ustawień regionalnych strumienia. Dla std::locale::classic() są to true i false. Nie należy zakładać, że dowolne ustawienia regionalne używają tych samych nazw. Manipulator nie zamienia liczb całkowitych w słowa.

Ustawienie dotyczy konkretnego strumienia i pozostaje aktywne także po następnej operacji. std::noboolalpha usuwa flagę, przywracając liczbowy zapis i odczyt wartości bool bez zmiany pozostałych flag formatowania. Na przykład przy klasycznych ustawieniach regionalnych i włączonej fladze std::ios_base::showpos wartość true jest zapisywana w formacie dziesiętnym jako +1. Zmiana formatu std::cout nie zmienia formatu osobnego strumienia wejściowego.

Przy odczycie tekst niepasujący do oczekiwanej nazwy powoduje ustawienie failbit; sprawdzaj wynik operacji, na przykład przez if (!(input >> std::boolalpha >> value)). Przykład ustala klasyczne ustawienia regionalne obu strumieni, odczytuje dwie wartości, a następnie pokazuje zapis tekstowy i liczbowy.

Przykłady

#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';
}

Wynik

true false
1 0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła