Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::ios::boolalpha — valori booleani in forma testuale

Imposta il flag `std::ios::boolalpha` con `setf` per leggere e scrivere i valori `bool` usando i nomi della locale del flusso anziché la rappresentazione numerica.

Versione: ISO C++23; implementation support may vary

Sintassi

#include <iostream>

// Inside a function:
const auto previous = std::cout.setf(std::ios::boolalpha);
std::cout << true;
std::cout.flags(previous);

std::ios::boolalpha è un flag di formato di tipo std::ios_base::fmtflags, non una funzione. std::ios è un alias di std::basic_ios<char>. Sia il flag sia la funzione membro setf sono dichiarati in std::ios_base e accessibili per ereditarietà.

std::cout.setf(std::ios::boolalpha) imposta il flag senza modificare gli altri e restituisce l’intero insieme precedente di flag. L’overload setf(flags, mask) sostituisce solo i bit selezionati dalla maschera. La chiamata non stampa nulla: è un successivo << a inserire il valore bool. Con la locale classica si ottiene true o false invece dei valori predefiniti 1 o 0. Gli interi come il letterale 1 di tipo int continuano a essere stampati come numeri.

L’impostazione riguarda quel flusso e resta attiva dopo l’inserimento successivo. Usa unsetf(std::ios::boolalpha) per azzerare solo quel flag oppure flags(previous) per ripristinare tutti i flag salvati. La funzione libera std::boolalpha, usata come in std::cout << std::boolalpha, imposta lo stesso flag. L’esempio chiama invece setf direttamente.

Su un flusso di input, lo stesso flag fa sì che >> per bool cerchi una corrispondenza con i nomi forniti dalla faccetta std::numpunct della locale di quel flusso. Se la lettura non trova una corrispondenza univoca, imposta failbit. Impostare il flag su std::cout non modifica std::cin.

Esempi

#include <iostream>
#include <locale>

int main() {
    std::cout.imbue(std::locale::classic());
    std::cout << true << ' ' << false << '\n';

    const auto previous = std::cout.setf(std::ios::boolalpha);
    std::cout << true << ' ' << false << '\n';

    std::cout.flags(previous);
    std::cout << true << ' ' << false << '\n';
}

Risultato

1 0
true false
1 0

`std::locale::classic()` fissa le grafie `true` e `false`. Il programma stampa i valori prima e dopo aver impostato il flag, poi dopo aver ripristinato i flag precedenti.

Lezioni correlate

  • C++ · Lezione 5 · Avanzato · Versione: 3

Fonti