CKTIS / C++
`std::basic_ios::setf`: opmaakvlaggen van een stream instellen
`setf` wijzigt de opmaakvlaggen van een stream. Met `std::ios::boolalpha` worden `bool`-waarden in de klassieke locale weergegeven als `true` en `false`.
Versie: ISO C++23; implementation support may vary
Syntax
// 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 is een overgeërfde lidfunctie: beide overloads zijn gedeclareerd in std::ios_base. std::ios is een alias voor std::basic_ios<char>, dus std::ios::boolalpha verwijst naar dezelfde overgeërfde vlag als std::ios_base::boolalpha.
setf(flags) zet de opgegeven bits aan en laat de andere ongemoeid. setf(flags, mask) vervangt alleen de door mask geselecteerde bits door de overeenkomstige bits uit flags. Gebruik bijvoorbeeld out.setf(std::ios_base::hex, std::ios_base::basefield) om het grondtal voor gehele getallen te wijzigen zonder de vlag voor het vorige grondtal aan te laten staan. Beide overloads geven de volledige vorige set vlaggen terug als std::ios_base::fmtflags, niet een foutcode of een verwijzing naar de stream.
std::cout.setf(std::ios::boolalpha) schrijft niets. De streaminvoegoperator << gebruikt de vlag pas wanneer die daarna een bool schrijft. In de klassieke locale levert dat true of false op in plaats van de gebruikelijke 1 of 0; een andere locale kan andere namen gebruiken. std::cout << std::boolalpha zet dezelfde vlag via een manipulator die geen lidfunctie is; het voorbeeld gebruikt die niet. De vlag verandert niets aan de weergave van de gehele getallen 1 en 0.
De vlag blijft na << op die stream aanstaan. Gebruik out.unsetf(std::ios::boolalpha) om alleen die vlag uit te zetten, of out.flags(previous) om de volledige opgeslagen set vlaggen te herstellen.
Voorbeelden
#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';
}Resultaat
1 0 true false 1 0
Het programma kiest expliciet `std::locale::classic()`. De verwachte regels zijn `1 0`, daarna `true false` en na herstel van de vlaggen opnieuw `1 0`.
Gerelateerde lessen
- C++ · Les 5 · Gevorderd · Versie: 3
Bronnen
- 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]