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
- Working Draft, Standard for Programming Language C++ (WG21 N4950)
- [iosfwd.syn] Header <iosfwd> synopsis
- [ios.overview] Class template basic_ios overview
- [ios.fmtflags] Type ios_base::fmtflags
- [fmtflags.state] State functions
- [basic.ios.cons] Constructors and initial stream state
- [fmtflags.manip] fmtflags manipulators
- [ostream.inserters.arithmetic] Arithmetic inserters
- [facet.num.put.virtuals] num_put virtual functions
- [facet.num.get.virtuals] num_get virtual functions
- [facet.numpunct.virtuals] numpunct virtual functions
- [locale.statics] Static members of locale