Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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