KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::boolalpha — bool-waarden als tekst in streams

std::boolalpha schakelt tekstuele invoer en uitvoer van bool-waarden in voor een bepaalde stream. In de klassieke locale zijn de namen true en false. De instelling blijft actief totdat deze wordt gewijzigd.

Versie: 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 is een streammanipulator die in <ios> is gedeclareerd. Gebruik out << std::boolalpha om de uitvoer in te stellen of in >> std::boolalpha voor de invoer. De functie zet de vlag std::ios_base::boolalpha en retourneert een verwijzing naar dezelfde stream; zelf schrijft of leest de functie geen waarde.

Als de vlag is ingeschakeld, worden waarden van het type bool geschreven en herkend met namen uit de locale van de stream. Voor std::locale::classic() zijn dat true en false. Ga er niet van uit dat elke locale dezelfde namen gebruikt. De manipulator zet gehele getallen niet om in woorden.

De instelling geldt voor de betreffende stream en blijft ook na de volgende bewerking actief. std::noboolalpha wist de vlag: bool-waarden worden weer numeriek ingelezen en uitgevoerd, zonder dat de andere opmaakvlaggen veranderen. Met de klassieke locale en std::ios_base::showpos ingeschakeld, wordt true bijvoorbeeld in decimale notatie als +1 weergegeven. De indeling van std::cout wijzigen verandert niet de indeling van een afzonderlijke invoerstream.

Bij invoer zorgt tekst die niet overeenkomt met de verwachte naam ervoor dat failbit wordt ingesteld. Controleer het resultaat van de bewerking, bijvoorbeeld met if (!(input >> std::boolalpha >> value)). Het voorbeeld geeft beide streams de klassieke locale, leest twee waarden en laat daarna tekstuele en numerieke uitvoer zien.

Voorbeelden

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

Resultaat

true false
1 0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen