CKTIS / C++
`std::basic_ios::setf`: impostare i flag di formattazione di uno stream
`setf` modifica i flag di formattazione di uno stream. Con `std::ios::boolalpha` e la locale classica, i valori `bool` vengono stampati come `true` e `false`.
Versione: ISO C++23; implementation support may vary
Sintassi
// Declared in std::ios_base (<ios>); inherited by std::basic_ios.
std::ios_base::fmtflags setf(std::ios_base::fmtflags flags);
std::ios_base::fmtflags setf(std::ios_base::fmtflags flags,
std::ios_base::fmtflags mask);std::basic_ios::setf è una funzione membro ereditata: entrambi gli overload sono dichiarati in std::ios_base. std::ios è un alias di std::basic_ios<char>, quindi std::ios::boolalpha indica lo stesso flag ereditato di std::ios_base::boolalpha.
setf(flags) attiva i bit indicati e lascia invariati gli altri. setf(flags, mask) sostituisce solo i bit selezionati da mask con i bit corrispondenti di flags. Usa, per esempio, out.setf(std::ios_base::hex, std::ios_base::basefield) per cambiare la base degli interi senza lasciare attivo il flag della base precedente. Entrambi gli overload restituiscono tutto l’insieme precedente dei flag come std::ios_base::fmtflags, non un codice di errore né un riferimento allo stream.
std::cout.setf(std::ios::boolalpha) non stampa nulla. È l’operatore di inserimento nello stream << a usare il flag quando in seguito scrive un valore bool. Con la locale classica si ottiene true o false anziché i consueti 1 o 0; un’altra locale può usare nomi diversi. std::cout << std::boolalpha attiva lo stesso flag tramite un manipolatore che è una funzione non membro; l’esempio non lo usa. Il flag non modifica la stampa degli interi 1 e 0.
Il flag resta attivo su quello stream dopo <<. Usa out.unsetf(std::ios::boolalpha) per disattivare solo quel flag, oppure out.flags(previous) per ripristinare l’intero insieme di flag salvato.
Esempi
#include <ios>
#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
Il programma seleziona esplicitamente `std::locale::classic()`. Le righe attese sono `1 0`, poi `true false` e infine di nuovo `1 0` dopo il ripristino dei flag.
Lezioni correlate
- C++ · Lezione 5 · Avanzato · Versione: 3
Fonti
- C++ working draft — ios_base state functions [fmtflags.state]
- C++ working draft — Class template basic_ios overview [ios.overview]
- C++ working draft — Header <iosfwd> synopsis [iosfwd.syn]
- C++ working draft — fmtflags manipulators [fmtflags.manip]
- C++ working draft — Arithmetic inserters [ostream.inserters.arithmetic]
- C++ working draft — num_put virtual functions [facet.num.put.virtuals]
- C++ working draft — Class template numpunct [locale.numpunct]