Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti