CKTIS / C++
std::setprecision — precisie van getalopmaak
std::setprecision uit <iomanip> stelt de precisie van een stream in. Bij std::defaultfloat bepaalt een positieve precisie het maximale aantal significante cijfers. Bij std::fixed en std::scientific bepaalt een niet-negatieve precisie het aantal cijfers na het decimaalteken; bij een negatieve precisie worden er standaard zes weergegeven. De instelling blijft actief voor volgende bewerkingen.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iomanip>
// std::setprecision(int n) returns an object of unspecified type.
out << std::setprecision(n);
in >> std::setprecision(n);std::setprecision(n) uit <iomanip> maakt een manipulator waarvan het retourtype niet door de standaard is vastgelegd. De expressie out << std::setprecision(n) werkt als out.precision(n) en kan met << worden voortgezet. Ze verandert de opmaakstatus van de stream, niet de opgeslagen numerieke waarde.
De betekenis van n hangt af van de modus. Met std::defaultfloat is het voor positieve waarden het maximale aantal significante cijfers; de uitvoer kan gewone of exponentiële notatie gebruiken en afsluitende nullen worden doorgaans weggelaten. Voor n >= 0 geeft std::fixed n cijfers na het decimaalteken weer, en std::scientific geeft evenveel cijfers weer na het decimaalteken in de mantisse van de exponentiële notatie. De manipulator accepteert ook negatieve waarden voor n en slaat die op in de stream. In beide modi wordt een negatieve precisie bij het opmaken behandeld alsof er geen precisie is opgegeven, zodat er standaard zes cijfers na het decimaalteken verschijnen. Met std::hexfloat wordt de precisie genegeerd.
De opmaak rondt de tekstuele weergave af in plaats van cijfers alleen af te kappen. Een hogere precisie verbetert de nauwkeurigheid van de opgeslagen waarde niet. De manipulator stelt noch de veldbreedte in, noch verandert hij de opmaak van gehele getallen. Het decimaalteken hangt af van de locale van de stream.
De instelling blijft actief totdat ze wordt gewijzigd. std::defaultfloat verandert de modus, maar herstelt geen eerdere precisie. Sla in hulpfuncties precision() op en herstel die; doe hetzelfde met flags() als de modus verandert. De syntaxis in >> std::setprecision(n) is geldig en stelt de precisietoestand van de invoerstream in; ze beperkt niet het aantal cijfers dat bij het gewoon inlezen van een kommagetal wordt verwerkt.
Voorbeelden
#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);
}
Resultaat
12.38 12.38 1.50 1.24e+01
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.