CKTIS / C++
std::ios::boolalpha — lire et écrire les booléens sous forme de texte
Activez l’indicateur `std::ios::boolalpha` avec `setf` pour lire et écrire les valeurs `bool` avec les noms de la locale du flux plutôt que sous forme numérique.
Version : ISO C++23; implementation support may vary
Syntaxe
#include <iostream>
// Inside a function:
const auto previous = std::cout.setf(std::ios::boolalpha);
std::cout << true;
std::cout.flags(previous);std::ios::boolalpha est un indicateur de format de type std::ios_base::fmtflags, pas une fonction. std::ios est un alias de std::basic_ios<char>. L’indicateur et la fonction membre setf sont déclarés dans std::ios_base et accessibles par héritage.
std::cout.setf(std::ios::boolalpha) active cet indicateur sans modifier les autres et renvoie l’ensemble des indicateurs précédents. La surcharge setf(flags, mask) ne remplace que les bits sélectionnés par le masque. L’appel lui-même n’affiche rien : c’est un << ultérieur qui écrit la valeur bool. Avec la locale classique, on obtient true ou false au lieu de 1 ou 0 par défaut. Les entiers, comme le littéral 1 de type int, restent affichés sous forme numérique.
Le réglage est propre au flux et reste actif après l’écriture suivante. Utilisez unsetf(std::ios::boolalpha) pour désactiver ce seul indicateur, ou flags(previous) pour rétablir tous les indicateurs sauvegardés. La fonction libre std::boolalpha, utilisée comme dans std::cout << std::boolalpha, active le même indicateur. L’exemple appelle plutôt setf directement.
Dans un flux d’entrée, ce même indicateur fait que >> pour un bool recherche les noms fournis par la facette std::numpunct de la locale de ce flux. Si la lecture ne trouve pas de correspondance unique, elle positionne failbit. Activer l’indicateur sur std::cout ne modifie pas std::cin.
Exemples
#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
`std::locale::classic()` fixe les formes `true` et `false`. Le programme affiche les valeurs avant et après l’activation de l’indicateur, puis après le rétablissement des indicateurs précédents.
Leçons associées
- C++ · Leçon 5 · Avancé · Version : 3
Sources
- Working Draft, Standard for Programming Language C++ (WG21 N4950)
- [iosfwd.syn] Header <iosfwd> synopsis
- [ios.overview] Class template basic_ios overview
- [ios.fmtflags] Type ios_base::fmtflags
- [fmtflags.state] State functions
- [basic.ios.cons] Constructors and initial stream state
- [fmtflags.manip] fmtflags manipulators
- [ostream.inserters.arithmetic] Arithmetic inserters
- [facet.num.put.virtuals] num_put virtual functions
- [facet.num.get.virtuals] num_get virtual functions
- [facet.numpunct.virtuals] numpunct virtual functions
- [locale.statics] Static members of locale