CKTIS / C++
`std::basic_ios::setf`: ustawianie flag formatowania strumienia
`setf` zmienia flagi formatowania konkretnego strumienia. Za pomocą `std::ios::boolalpha` można wypisywać wartości `bool` jako `true` i `false` w klasycznych ustawieniach regionalnych.
Wersja: ISO C++23; implementation support may vary
Składnia
// 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 to funkcja składowa odziedziczona z std::ios_base, gdzie zadeklarowano oba przeciążenia. std::ios jest aliasem std::basic_ios<char>, więc std::ios::boolalpha oznacza tę samą odziedziczoną flagę co std::ios_base::boolalpha.
setf(flags) włącza wskazane bity, pozostawiając pozostałe bez zmian. setf(flags, mask) zastępuje tylko bity wybrane przez mask odpowiadającymi im bitami z flags. Aby zmienić podstawę systemu liczbowego bez pozostawiania poprzedniego ustawienia, użyj out.setf(std::ios_base::hex, std::ios_base::basefield). Oba przeciążenia zwracają pełny poprzedni zestaw flag typu std::ios_base::fmtflags, a nie kod błędu ani referencję do strumienia.
std::cout.setf(std::ios::boolalpha) niczego nie wypisuje. Dopiero operator wstawiania do strumienia << używa flagi podczas wypisywania wartości bool. W klasycznych ustawieniach regionalnych wynikiem są true i false zamiast zwykłych 1 i 0; inne ustawienia regionalne mogą używać innych nazw. std::cout << std::boolalpha włącza tę samą flagę za pomocą manipulatora będącego funkcją nieskładową; przykład go nie używa. Flaga nie zmienia sposobu wypisywania liczb całkowitych 1 i 0.
Flaga pozostaje ustawiona w danym strumieniu po operacji <<. Aby wyłączyć tylko ją, użyj out.unsetf(std::ios::boolalpha). Aby odtworzyć cały zapisany zestaw flag, użyj out.flags(previous).
Przykłady
#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';
}Wynik
1 0 true false 1 0
Program jawnie wybiera `std::locale::classic()`. Oczekiwane wiersze to kolejno `1 0`, `true false` i ponownie `1 0` po przywróceniu flag.
Powiązane lekcje
- C++ · Lekcja 5 · Zaawansowany · Wersja: 3
Źródła
- 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]