std::cerr, std::wcerr

グローバルオブジェクト std::cerr および std::wcerr は標準 C エラー出力ストリーム stderr に紐付けられている処理系定義の (それぞれ std::streambuf および std::wstreambuf から派生した) 型のストリームバッファへの出力を制御します。

これらのオブジェクトは std::ios_base::Init 型のオブジェクトが最初に構築されるときまたはそれより前に初期化されることが保証されており、順序付き初期化を行う静的オブジェクトのコンストラクタおよびデストラクタ内で使用することができます (そのオブジェクトが定義されるより前に <iostream> ��インクルードされている限り)。

sync_with_stdio(false) が行われていなければ、書式付き出力と書式なし出力のどちらについても、これらのオブジェクトに複数のスレッドから並行的にアクセスしても安全です。

いったん初期化されると、 (std::cerr.flags() & unitbuf) != 0 になります (wcerr についても同様です)。 これは、これらのストリームオブジェクトに送られたあらゆる出力が直ちに (std::basic_ostream::sentry のデストラクタを通して) OS にフラッシュされることを意味します。

[編集] ノート

名前の中の「c」は「character」を表します (stroustrup.com FAQ)。 cerr は「character error (stream)」、 wcerr は「wide character error (stream)」という意味です。

[編集] 例

#include <thread>
#include <iostream>
#include <chrono>
void f()
{
    std::cout << "Output from thread...";
    std::this_thread::sleep_for(std::chrono::seconds(2));
    std::cout << "...thread calls flush()" << std::endl;
}
 
int main()
{
    std::thread t1(f);
    std::this_thread::sleep_for(std::chrono::seconds(1));
    std::clog << "This output from main is not tie()'d to cout\n";
    std::cerr << "This output is tie()'d to cout\n";
    t1.join();
}

This output from main is not tie()'d to cout
Output from thread...This output is tie()'d to cout
...thread calls flush()

[編集] 関連項目