CKTIS / C++
`std::basic_ios::setf`: nastavení formátovacích příznaků proudu
`setf` mění formátovací příznaky proudu. S příznakem `std::ios::boolalpha` se při klasickém místním nastavení hodnoty typu `bool` vypisují jako `true` a `false`.
Verze: ISO C++23; implementation support may vary
Syntaxe
// 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 je zděděná členská funkce: obě přetížení jsou deklarována v std::ios_base. std::ios je alias pro std::basic_ios<char>, takže std::ios::boolalpha označuje stejný zděděný příznak jako std::ios_base::boolalpha.
setf(flags) nastaví uvedené bity a ostatní ponechá beze změny. setf(flags, mask) nahradí pouze bity vybrané maskou mask odpovídajícími bity z flags. Například out.setf(std::ios_base::hex, std::ios_base::basefield) změní základ číselné soustavy pro celá čísla, aniž by zůstal nastaven příznak předchozího základu. Obě přetížení vracejí úplnou předchozí sadu příznaků typu std::ios_base::fmtflags, nikoli chybový kód ani referenci na proud.
std::cout.setf(std::ios::boolalpha) nic nevypisuje. Příznak použije až operátor vkládání do proudu << při následném výpisu hodnoty typu bool. Při klasickém místním nastavení je výsledkem true nebo false místo obvyklých 1 nebo 0; jiné místní nastavení může použít jiné názvy. std::cout << std::boolalpha nastaví stejný příznak pomocí manipulátoru, který je nečlenskou funkcí; příklad jej nepoužívá. Příznak nemění výpis celých čísel 1 a 0.
Příznak zůstane v daném proudu nastaven i po <<. Chceš-li zrušit pouze tento příznak, použij out.unsetf(std::ios::boolalpha). Celou uloženou sadu příznaků obnovíš pomocí out.flags(previous).
Příklady
#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';
}Výsledek
1 0 true false 1 0
Program výslovně volí `std::locale::classic()`. Očekávané řádky jsou `1 0`, poté `true false` a po obnovení příznaků znovu `1 0`.
Související lekce
- C++ · Lekce 5 · Pokročilá · Verze: 3
Zdroje
- 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]