Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::setprecision — přesnost formátování čísel

std::setprecision z <iomanip> nastavuje přesnost proudu. Při std::defaultfloat kladná přesnost určuje maximální počet platných číslic. Při std::fixed a std::scientific nezáporná přesnost určuje počet číslic za desetinným oddělovačem; při záporné přesnosti se použije výchozích šest číslic. Nastavení zůstává aktivní pro následující operace.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <iomanip>
// std::setprecision(int n) returns an object of unspecified type.
out << std::setprecision(n);
in >> std::setprecision(n);

std::setprecision(n) z <iomanip> vytváří manipulátor, jehož návratový typ standard nespecifikuje. Výraz out << std::setprecision(n) funguje jako out.precision(n) a lze za něj připojit další části pomocí <<. Mění stav formátování proudu, nikoli uloženou číselnou hodnotu.

Význam n závisí na režimu. Při std::defaultfloat jde pro kladné hodnoty o maximální počet platných číslic; výstup může použít běžný nebo exponenciální zápis a koncové nuly se obvykle vynechávají. Pro n >= 0 vypíše std::fixed za desetinným oddělovačem n číslic a std::scientific vypíše stejný počet číslic za oddělovačem v mantise exponenciálního zápisu. Manipulátor přijímá i záporné hodnoty n a ukládá je do proudu. V obou těchto režimech se při formátování se zápornou přesností zachází, jako by nebyla zadána, a za desetinným oddělovačem se vypíše výchozích šest číslic. Při std::hexfloat se přesnost ignoruje.

Formátování zaokrouhluje textovou reprezentaci, místo aby číslice pouze zkracovalo. Vyšší přesnost nezvyšuje přesnost uložené hodnoty. Manipulátor nenastavuje šířku pole ani nemění formátování výstupu celých čísel. Desetinný oddělovač závisí na lokalizaci proudu.

Nastavení zůstává aktivní, dokud se nezmění. std::defaultfloat mění režim, ale neobnovuje předchozí přesnost. V pomocném kódu uložte a obnovte precision() a pokud se mění režim, také flags(). Syntaxe in >> std::setprecision(n) je platná a nastavuje stav přesnosti vstupního proudu; neomezuje počet číslic spotřebovaných při běžném načítání čísla s plovoucí desetinnou čárkou.

Příklady

#include <iomanip>
#include <iostream>
#include <locale>

int main() {
    std::cout.imbue(std::locale::classic());
    const double value = 12.375;
    const auto oldPrecision = std::cout.precision();
    const auto oldFlags = std::cout.flags();

    std::cout << std::defaultfloat << std::setprecision(4)
              << value << '\n';
    std::cout << std::fixed << std::setprecision(2)
              << value << '\n';
    std::cout << 1.5 << '\n';
    std::cout << std::scientific << value << '\n';

    std::cout.precision(oldPrecision);
    std::cout.flags(oldFlags);
}

Výsledek

12.38
12.38
1.50
1.24e+01

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje