std::basic_ostream<CharT,Traits>:: put

Se comporte comme une UnformattedOutputFunction . Après avoir construit et vérifié l'objet sentry, écrit le caractère ch dans le flux de sortie.

Si la sortie échoue pour une raison quelconque, positionne badbit .

Paramètres

Valeur de retour

* this

Notes

Cette fonction n'est pas surchargée pour les types signed char ou unsigned char , contrairement à l' operator<< formaté.

Contrairement aux fonctions de sortie formatées, cette fonction ne définit pas le failbit si la sortie échoue.

Exemple

#include <fstream>
#include <iostream>
int main()
{
    std::cout.put('a'); // utilisation normale
    std::cout.put('\n');
    std::ofstream s("/does/not/exist/");
    s.clear(); // simuler que le flux est valide
    std::cout << "Sortie non formatée : ";
    s.put('c'); // cela définira badbit, mais pas failbit
    std::cout << " fail=" << bool(s.rdstate() & s.failbit);
    std::cout << " bad=" << s.bad() << '\n';
    s.clear();
    std::cout << "Sortie formatée :     ";
    s << 'c'; // cela définira badbit et failbit
    std::cout << " fail=" << bool(s.rdstate() & s.failbit);
    std::cout << " bad=" << s.bad() << '\n';
}

a
Unformatted output:  fail=0 bad=1
Formatted output:    fail=1 bad=1

Voir aussi