Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::setprecision — précision du formatage numérique

std::setprecision, défini dans <iomanip>, règle la précision d’un flux. Avec std::defaultfloat, une précision positive fixe le nombre maximal de chiffres significatifs. Avec std::fixed et std::scientific, une précision positive ou nulle fixe le nombre de chiffres après le séparateur décimal ; si elle est négative, le formatage en utilise six par défaut. Le réglage reste actif pour les opérations suivantes.

Version : 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), défini dans <iomanip>, crée un manipulateur dont le type de retour n’est pas spécifié par la norme. L’expression out << std::setprecision(n) agit comme out.precision(n) et permet de poursuivre l’enchaînement avec <<. Elle modifie l’état de formatage du flux, et non la valeur numérique stockée.

La signification de n dépend du mode. Avec std::defaultfloat, pour une valeur positive, il s’agit du nombre maximal de chiffres significatifs ; la sortie peut utiliser une notation ordinaire ou exponentielle, et les zéros finaux sont généralement omis. Pour n >= 0, std::fixed affiche n chiffres après le séparateur décimal, et std::scientific en affiche autant après le séparateur dans la mantisse de la notation exponentielle. Le manipulateur accepte également les valeurs négatives de n et les enregistre dans le flux. Dans ces deux modes, le formatage traite une précision négative comme si elle n’avait pas été indiquée et utilise donc par défaut six chiffres après le séparateur décimal. Avec std::hexfloat, la précision est ignorée.

Le formatage arrondit la représentation textuelle au lieu de simplement tronquer les chiffres. Augmenter la précision n’améliore pas l’exactitude de la valeur stockée. Le manipulateur ne règle pas la largeur du champ et ne modifie pas le formatage des entiers. Le séparateur décimal dépend de la locale du flux.

Le réglage reste actif jusqu’à sa modification. std::defaultfloat change le mode, mais ne rétablit pas une précision antérieure. Dans du code utilitaire, sauvegardez puis restaurez precision() et, si le mode a changé, flags(). La syntaxe in >> std::setprecision(n) est valide et règle l’état de précision du flux d’entrée ; elle ne limite pas le nombre de chiffres consommés lors de la lecture ordinaire d’un nombre à virgule flottante.

Exemples

#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);
}

Résultat

12.38
12.38
1.50
1.24e+01

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources