CKTIS / C++
std::setprecision — precisione della formattazione numerica
std::setprecision, definito in <iomanip>, imposta la precisione di uno stream. Con std::defaultfloat una precisione positiva fissa il numero massimo di cifre significative. Con std::fixed e std::scientific una precisione non negativa fissa il numero di cifre dopo il separatore decimale; se è negativa, si usano sei cifre per impostazione predefinita. L’impostazione resta attiva per le operazioni successive.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <iomanip>
// std::setprecision(int n) returns an object of unspecified type.
out << std::setprecision(n);
in >> std::setprecision(n);std::setprecision(n), definito in <iomanip>, crea un manipolatore il cui tipo restituito non è specificato dallo standard. L’espressione out << std::setprecision(n) agisce come out.precision(n) e consente di continuare la catena con <<. Modifica lo stato di formattazione dello stream, non il valore numerico memorizzato.
Il significato di n dipende dalla modalità. Con std::defaultfloat, per valori positivi è il numero massimo di cifre significative; l’output può usare la notazione ordinaria o esponenziale e gli zeri finali vengono normalmente omessi. Per n >= 0, std::fixed scrive n cifre dopo il separatore decimale e std::scientific ne scrive altrettante dopo il separatore nella mantissa della notazione esponenziale. Il manipolatore accetta anche valori negativi di n e li memorizza nello stream. In entrambe le modalità, la formattazione tratta una precisione negativa come se non fosse stata specificata e usa quindi il valore predefinito di sei cifre dopo il separatore decimale. Con std::hexfloat la precisione viene ignorata.
La formattazione arrotonda la rappresentazione testuale, anziché limitarsi a troncare le cifre. Aumentare la precisione non migliora l’accuratezza del valore memorizzato. Il manipolatore non imposta la larghezza del campo e non cambia il formato di output degli interi. Il separatore decimale dipende dalla locale dello stream.
L’impostazione resta attiva finché non viene modificata. std::defaultfloat cambia modalità, ma non ripristina una precisione precedente. Nel codice di supporto, salva e ripristina precision() e, se cambia la modalità, anche flags(). La sintassi in >> std::setprecision(n) è valida e imposta lo stato di precisione dello stream di input; non limita il numero di cifre consumate durante la normale lettura di un numero in virgola mobile.
Esempi
#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);
}
Risultato
12.38 12.38 1.50 1.24e+01
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.