std::cerr, std::wcerr

extern std::ostream cerr;

extern std::wostream wcerr;

Глобальные объекты std::cerr и std::wcerr управляют выводом в буфер потока типа, определяемого реализацией (производного от std::streambuf и std::wstreambuf соответственно), связанный со стандартным потоком вывода ошибок C stderr.

Гарантируется, что эти объекты будут инициализированы во время или до первого создания объекта типа std::ios_base::Init, и они доступны для использования в конструкторах и деструкторах статических объектов с упорядоченной инициализацией (если <iostream> включен до определения объекта).

Если не был вызван std::ios_base::sync_with_stdio(false), безопасно одновременно обращаться к этим объектам из нескольких потоков для форматированного и неформатированного вывода.

После инициализации (std::cerr.flags() & unitbuf) != 0 (то же относится к std::wcerr), то есть любой вывод, отправленный в эти потоковые объекты, немедленно сбрасывается в ОС (через деструктор std::basic_ostream::sentry).

Кроме того, std::cerr.tie() возвращает &std::cout (то же относится к std::wcerr и std::wcout), то есть любая операция вывода в std::cerr сначала выполняет std::cout.flush() (через конструктор std::basic_ostream::sentry).

Примечания

Буква «c» в названии означает «character» («символ») (FAQ на stroustrup.com); cerr означает «ошибка символа (поток)», а wcerr — «ошибка широкого символа (поток)».

Пример

#include <chrono>
#include <iostream>
#include <thread>
using namespace std::chrono_literals;

void f()
{
    std::cout << "Output from thread...";
    std::this_thread::sleep_for(2s);
    std::cout << "...thread calls flush()" << std::endl;
}

int main()
{
    std::jthread t1{f};
    std::this_thread::sleep_for(1000ms);
    std::clog << "This output from main is not tie()'d to cout\n";
    std::cerr << "This output is tie()'d to cout\n";
}

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

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

См. также