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

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