Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła