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.