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

UnformattedOutputFunction として振る舞う。セントリオブジェクトを構築・チェックした後、文字 ch を出力ストリームに書き込む。

出力が何らかの理由で失敗した場合、 badbit を設定します。

パラメータ

戻り値

* this

注記

この関数は、フォーマット済みの operator<< とは異なり、 signed char または unsigned char 型に対してオーバーロードされていません。

書式化出力関数とは異なり、この関数は出力が失敗した場合に failbit を設定しません。

例

#include <fstream>
#include <iostream>
int main()
{
    std::cout.put('a'); // 通常の使用法
    std::cout.put('\n');
    std::ofstream s("/does/not/exist/");
    s.clear(); // ストリームが正常であると仮定
    std::cout << "Unformatted output: ";
    s.put('c'); // これはbadbitを設定するが、failbitは設定しない
    std::cout << " fail=" << bool(s.rdstate() & s.failbit);
    std::cout << " bad=" << s.bad() << '\n';
    s.clear();
    std::cout << "Formatted output:   ";
    s << 'c'; // これはbadbitと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

関連項目