CKTIS / C++
std::ios_base: flagi formatowania i precyzja
std::ios_base przechowuje stan formatowania strumienia. Poznaj różnicę między przeciążeniami setf, znaczenie precision oraz bezpieczne włączanie fixed i boolalpha z późniejszym przywróceniem ustawień.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
std::ios_base::fmtflags setf(std::ios_base::fmtflags fmtfl);
std::ios_base::fmtflags setf(std::ios_base::fmtflags fmtfl, std::ios_base::fmtflags mask);
std::streamsize precision() const;
std::streamsize precision(std::streamsize prec);
stream.setf(std::ios_base::fixed, std::ios_base::floatfield);
stream.precision(2);
stream.setf(std::ios_base::boolalpha);std::ios_base przechowuje ustawienia formatowania danego strumienia. std::ios_base::setf i std::ios_base::precision są funkcjami składowymi; std::ios_base::fixed i std::ios_base::boolalpha to flagi typu fmtflags, a nie manipulatory std::fixed i std::boolalpha. Ustawienia pozostają aktywne do kolejnej zmiany.
setf(fmtfl) dodaje wskazane bity bez kasowania pozostałych. setf(fmtfl, mask) najpierw usuwa bity wskazane przez mask, a następnie ustawia fmtfl & mask. Oba przeciążenia zwracają poprzedni pełny zestaw flag. Do wyboru zapisu stałoprzecinkowego używaj setf(std::ios_base::fixed, std::ios_base::floatfield): samo dodanie fixed nie usuwa scientific; oba bity razem wybierają zapis szesnastkowy liczb zmiennoprzecinkowych.
precision() odczytuje precyzję, a precision(n) ustawia ją i zwraca poprzednią wartość. W trybie fixed precyzja określa liczbę cyfr po separatorze dziesiętnym; w domyślnym trybie zmiennoprzecinkowym określa liczbę cyfr znaczących. Nie zmienia przechowywanej wartości liczby. boolalpha włącza słowny zapis i odczyt bool; nazwy zależą od ustawień regionalnych. Przy std::locale::classic() są to true i false, zamiast liczbowego wyjścia 1 i 0.
Przykład używa lokalnego strumienia z std::locale::classic(), aby ustabilizować separator dziesiętny i nazwy wartości logicznych. Zapisuje flagi oraz precyzję, a potem przywraca je osobno przez flags(savedFlags) i precision(savedPrecision). W kodzie korzystającym ze współdzielonego strumienia zadbaj również o przywrócenie ustawień przy wyjątkach, np. przez strażnika RAII.
Przykłady
#include <iostream>
#include <locale>
#include <sstream>
int main() {
std::ostringstream out;
out.imbue(std::locale::classic());
const auto savedFlags = out.setf(
std::ios_base::fixed, std::ios_base::floatfield);
const auto savedPrecision = out.precision(2);
out.setf(std::ios_base::boolalpha);
out << 12.5 << ' ' << true << ' ' << false << '\n';
out.flags(savedFlags);
out.precision(savedPrecision);
out << 12.5 << ' ' << true << ' ' << false << '\n';
std::cout << out.str();
}
Wynik
12.50 true false 12.5 1 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.