CKTIS / C++
std::setprecision — Genauigkeit der Zahlenformatierung
std::setprecision aus <iomanip> legt die Genauigkeit eines Streams fest. Bei std::defaultfloat gibt eine positive Genauigkeit die maximale Anzahl signifikanter Stellen an. Bei std::fixed und std::scientific gibt eine nichtnegative Genauigkeit die Anzahl der Ziffern nach dem Dezimaltrennzeichen an; bei negativer Genauigkeit werden standardmäßig sechs Ziffern ausgegeben. Die Einstellung bleibt für nachfolgende Operationen aktiv.
Version: 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) aus <iomanip> erzeugt einen Manipulator, dessen Rückgabetyp vom Standard nicht festgelegt ist. Der Ausdruck out << std::setprecision(n) wirkt wie out.precision(n) und kann mit << verkettet werden. Er ändert den Formatierungszustand des Streams, nicht den gespeicherten Zahlenwert.
Die Bedeutung von n hängt vom Modus ab. Bei std::defaultfloat ist es für positive Werte die maximale Anzahl signifikanter Stellen; die Ausgabe kann in gewöhnlicher oder exponentieller Schreibweise erfolgen, und nachgestellte Nullen werden normalerweise weggelassen. Für n >= 0 gibt std::fixed genau n Ziffern nach dem Dezimaltrennzeichen aus. std::scientific gibt ebenso viele Ziffern nach dem Trennzeichen in der Mantisse der exponentiellen Schreibweise aus. Der Manipulator akzeptiert auch negative Werte für n und speichert sie im Stream. In diesen beiden Modi wird bei negativer Genauigkeit so formatiert, als wäre keine Genauigkeit angegeben, sodass standardmäßig sechs Ziffern nach dem Dezimaltrennzeichen ausgegeben werden. Bei std::hexfloat wird die Genauigkeit ignoriert.
Die Formatierung rundet die Textdarstellung, statt Ziffern lediglich abzuschneiden. Eine höhere Genauigkeit verbessert nicht die Genauigkeit des gespeicherten Werts. Der Manipulator setzt weder die Feldbreite noch ändert er die Formatierung ganzzahliger Ausgaben. Das Dezimaltrennzeichen hängt von der Locale des Streams ab.
Die Einstellung bleibt aktiv, bis sie geändert wird. std::defaultfloat ändert den Modus, stellt aber keine vorherige Genauigkeit wieder her. In Hilfsfunktionen sollten Sie precision() und, falls der Modus geändert wird, auch flags() sichern und wiederherstellen. Die Syntax in >> std::setprecision(n) ist gültig und setzt den Genauigkeitszustand des Eingabestreams; sie begrenzt nicht die Anzahl der Ziffern, die beim gewöhnlichen Einlesen einer Gleitkommazahl verarbeitet werden.
Beispiele
#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);
}
Ergebnis
12.38 12.38 1.50 1.24e+01
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.