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

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