Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::boolalpha — textový zápis hodnot bool ve streamech

std::boolalpha zapíná textový výstup a vstup hodnot bool v konkrétním streamu. V klasickém locale se používají názvy true a false. Nastavení zůstává aktivní, dokud se nezmění.

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

Syntaxe

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

std::boolalpha je manipulátor streamu deklarovaný v <ios>. Pomocí out << std::boolalpha nastavíte výstup, pomocí in >> std::boolalpha vstup. Funkce nastaví příznak std::ios_base::boolalpha a vrátí referenci na tentýž stream; sama žádnou hodnotu nezapisuje ani nečte.

Je-li příznak zapnutý, hodnoty typu bool se zapisují a rozpoznávají pomocí názvů z locale daného streamu. Pro std::locale::classic() jsou to true a false. Nepředpokládejte, že všechna locale používají stejné názvy. Manipulátor nepřevádí celá čísla na slova.

Nastavení platí pro konkrétní stream a zůstává aktivní i po další operaci. std::noboolalpha příznak zruší, takže se hodnoty typu bool opět zapisují a čtou v číselné podobě. Ostatní formátovací příznaky se nemění. Například s klasickým locale a zapnutým příznakem std::ios_base::showpos se hodnota true v desítkovém formátu vypíše jako +1. Změna formátu std::cout nezmění formát samostatného vstupního streamu.

Při vstupu text, který neodpovídá očekávanému názvu, způsobí nastavení failbit; kontrolujte výsledek operace, například pomocí if (!(input >> std::boolalpha >> value)). Příklad nastaví klasické locale obou streamů, načte dvě hodnoty a poté ukáže textový a číselný výstup.

Příklady

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

Výsledek

true false
1 0

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje