CKTIS / C++
`std::basic_ios::setf` : modifier les indicateurs de formatage d’un flux
`setf` modifie les indicateurs de formatage d’un flux. Avec `std::ios::boolalpha` et les paramètres régionaux classiques, les valeurs `bool` s’affichent sous la forme `true` ou `false`.
Version : ISO C++23; implementation support may vary
Syntaxe
// Declared in std::ios_base (<ios>); inherited by std::basic_ios.
std::ios_base::fmtflags setf(std::ios_base::fmtflags flags);
std::ios_base::fmtflags setf(std::ios_base::fmtflags flags,
std::ios_base::fmtflags mask);std::basic_ios::setf est une fonction membre héritée : ses deux surcharges sont déclarées dans std::ios_base. std::ios est un alias de std::basic_ios<char>. Ainsi, std::ios::boolalpha désigne le même indicateur hérité que std::ios_base::boolalpha.
setf(flags) active les bits indiqués sans modifier les autres. setf(flags, mask) remplace uniquement les bits sélectionnés par mask par ceux qui leur correspondent dans flags. Utilisez par exemple out.setf(std::ios_base::hex, std::ios_base::basefield) pour changer la base de représentation des entiers sans laisser l’ancien indicateur de base actif. Les deux surcharges renvoient l’ensemble des indicateurs précédents sous la forme d’un std::ios_base::fmtflags, et non un code d’erreur ou une référence au flux.
std::cout.setf(std::ios::boolalpha) n’affiche rien. C’est l’opérateur d’insertion << qui tient ensuite compte de l’indicateur lorsqu’il écrit une valeur bool. Avec les paramètres régionaux classiques, le résultat est true ou false au lieu de 1 ou 0 comme à l’ordinaire ; d’autres paramètres régionaux peuvent employer d’autres noms. std::cout << std::boolalpha active le même indicateur au moyen d’un manipulateur qui est une fonction non membre ; l’exemple ne l’utilise pas. L’indicateur ne change pas l’affichage des entiers 1 et 0.
L’indicateur reste actif sur ce flux après <<. Utilisez out.unsetf(std::ios::boolalpha) pour désactiver uniquement cet indicateur, ou out.flags(previous) pour rétablir tous les indicateurs enregistrés.
Exemples
#include <ios>
#include <iostream>
#include <locale>
int main() {
std::cout.imbue(std::locale::classic());
std::cout << true << ' ' << false << '\n';
const auto previous = std::cout.setf(std::ios::boolalpha);
std::cout << true << ' ' << false << '\n';
std::cout.flags(previous);
std::cout << true << ' ' << false << '\n';
}Résultat
1 0 true false 1 0
Le programme sélectionne explicitement `std::locale::classic()`. Les lignes attendues sont `1 0`, puis `true false`, puis de nouveau `1 0` après le rétablissement des indicateurs.
Leçons associées
- C++ · Leçon 5 · Avancé · Version : 3
Sources
- C++ working draft — ios_base state functions [fmtflags.state]
- C++ working draft — Class template basic_ios overview [ios.overview]
- C++ working draft — Header <iosfwd> synopsis [iosfwd.syn]
- C++ working draft — fmtflags manipulators [fmtflags.manip]
- C++ working draft — Arithmetic inserters [ostream.inserters.arithmetic]
- C++ working draft — num_put virtual functions [facet.num.put.virtuals]
- C++ working draft — Class template numpunct [locale.numpunct]