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

CKTIS / C++

std::ios_base : indicateurs de formatage et précision

std::ios_base stocke l’état de formatage d’un flux. Découvrez la différence entre les surcharges de setf, la signification de precision et comment activer fixed et boolalpha tout en conservant les paramètres pour les rétablir ensuite.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

std::ios_base::fmtflags setf(std::ios_base::fmtflags fmtfl);
std::ios_base::fmtflags setf(std::ios_base::fmtflags fmtfl, std::ios_base::fmtflags mask);
std::streamsize precision() const;
std::streamsize precision(std::streamsize prec);

stream.setf(std::ios_base::fixed, std::ios_base::floatfield);
stream.precision(2);
stream.setf(std::ios_base::boolalpha);

std::ios_base stocke les paramètres de formatage d’un flux donné. std::ios_base::setf et std::ios_base::precision sont des fonctions membres ; std::ios_base::fixed et std::ios_base::boolalpha sont des indicateurs fmtflags, et non les manipulateurs std::fixed et std::boolalpha. Les paramètres restent actifs jusqu’à leur prochaine modification.

setf(fmtfl) ajoute les bits indiqués sans effacer les autres. setf(fmtfl, mask) efface d’abord les bits sélectionnés par mask, puis définit fmtfl & mask. Les deux surcharges renvoient l’ensemble complet des indicateurs précédent. Pour choisir la notation à virgule fixe, utilisez setf(std::ios_base::fixed, std::ios_base::floatfield) : ajouter simplement fixed n’efface pas scientific ; lorsque les deux bits sont définis, la notation hexadécimale en virgule flottante est sélectionnée.

precision() lit la précision, tandis que precision(n) la définit et renvoie la valeur précédente. En mode fixed, la précision indique le nombre de chiffres après le séparateur décimal ; dans le mode à virgule flottante par défaut, elle indique le nombre de chiffres significatifs. Elle ne modifie pas la valeur numérique stockée. boolalpha active l’écriture et la lecture textuelles de bool ; les noms dépendent de la locale. Avec std::locale::classic(), ils sont true et false, au lieu de la sortie numérique 1 et 0.

L’exemple utilise un flux local avec std::locale::classic() afin de stabiliser le séparateur décimal et les noms booléens. Il enregistre les indicateurs et la précision, puis les rétablit séparément avec flags(savedFlags) et precision(savedPrecision). Pour un flux partagé, prévoyez également de rétablir les paramètres si une exception se produit, par exemple au moyen d’une garde RAII.

Exemples

#include <iostream>
#include <locale>
#include <sstream>

int main() {
    std::ostringstream out;
    out.imbue(std::locale::classic());

    const auto savedFlags = out.setf(
        std::ios_base::fixed, std::ios_base::floatfield);
    const auto savedPrecision = out.precision(2);
    out.setf(std::ios_base::boolalpha);

    out << 12.5 << ' ' << true << ' ' << false << '\n';

    out.flags(savedFlags);
    out.precision(savedPrecision);
    out << 12.5 << ' ' << true << ' ' << false << '\n';

    std::cout << out.str();
}

Résultat

12.50 true false
12.5 1 0

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