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

Verhält sich wie eine UnformattedOutputFunction . Nach dem Konstruieren und Prüfen des Sentry-Objekts wird das Zeichen ch in den Ausgabestrom geschrieben.

Wenn die Ausgabe aus irgendeinem Grund fehlschlägt, setzt es badbit .

Parameter

Rückgabewert

* this

Hinweise

Diese Funktion ist nicht überladen für die Typen signed char oder unsigned char , im Gegensatz zum formatierten operator<< .

Im Gegensatz zu formatierten Ausgabefunktionen setzt diese Funktion nicht das failbit , falls die Ausgabe fehlschlägt.

Beispiel

#include <fstream>
#include <iostream>
int main()
{
    std::cout.put('a'); // normale Verwendung
    std::cout.put('\n');
    std::ofstream s("/does/not/exist/");
    s.clear(); // vortäuschen, dass der Stream in Ordnung ist
    std::cout << "Unformatted output: ";
    s.put('c'); // dies setzt badbit, aber nicht failbit
    std::cout << " fail=" << bool(s.rdstate() & s.failbit);
    std::cout << " bad=" << s.bad() << '\n';
    s.clear();
    std::cout << "Formatted output:   ";
    s << 'c'; // dies setzt badbit und 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

Siehe auch