Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::boolalpha — valori bool in formato testuale negli stream

std::boolalpha abilita l’output e l’input testuali dei valori bool in uno specifico stream. Con la locale classica, i nomi usati sono true e false. L’impostazione resta attiva finché non viene modificata.

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

Sintassi

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

std::boolalpha è un manipolatore di stream dichiarato in <ios>. Usa out << std::boolalpha per configurare l’output oppure in >> std::boolalpha per configurare l’input. La funzione imposta il flag std::ios_base::boolalpha e restituisce un riferimento allo stesso stream; non scrive né legge direttamente alcun valore.

Quando il flag è attivo, i valori di tipo bool vengono scritti e riconosciuti usando i nomi della locale dello stream. Per std::locale::classic() sono true e false. Non dare per scontato che tutte le locale usino gli stessi nomi. Il manipolatore non trasforma gli interi in parole.

L’impostazione riguarda lo specifico stream e resta attiva anche dopo l’operazione successiva. std::noboolalpha cancella il flag e ripristina la scrittura e la lettura numeriche dei valori bool, senza modificare gli altri flag di formattazione. Ad esempio, con la locale classica e std::ios_base::showpos attivo, true viene scritto come +1 in formato decimale. Modificare il formato di std::cout non cambia il formato di uno stream di input separato.

In input, il testo che non corrisponde al nome previsto fa impostare failbit; controlla il risultato dell’operazione, per esempio con if (!(input >> std::boolalpha >> value)). L’esempio imposta la locale classica per entrambi gli stream, legge due valori e poi mostra l’output testuale e quello numerico.

Esempi

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

Risultato

true false
1 0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti