std::cout, std::wcout

extern std::ostream cout;

extern std::wostream wcout;

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

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

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

Согласно спецификации std::cin, std::cin.tie() возвращает &std::cout. Это означает, что любая операция ввода с std::cin выполняет std::cout.flush() (через конструктор std::basic_istream::sentry). Аналогично, std::wcin.tie() возвращает &std::wcout.

Согласно спецификации std::cerr, std::cerr.tie() возвращает &std::cout. Это означает, что любая операция вывода с std::cerr выполняет std::cout.flush() (через конструктор std::basic_ostream::sentry). Аналогично, std::wcerr.tie() возвращает &std::wcout. (начиная с C++11)

Примечания

Буква «c» в названии означает «character» («символ») (раздел часто задаваемых вопросов на stroustrup.com); cout означает «вывод символов», а wcout — «вывод широких символов».

Поскольку динамическая инициализация шаблонных переменных не упорядочена, не гарантируется, что std::cout будет инициализировано до пригодного для использования состояния до начала инициализации таких переменных, если только объект типа std::ios_base::Init не был создан.

Пример

#include <iostream>

struct Foo
{
    int n;
    Foo()
    {
        std::cout << "static constructor\n";
    }
    ~Foo()
    {
        std::cout << "static destructor\n";
    }
};

Foo f; // static object

int main()
{
    std::cout << "main function\n";
}

static constructor
main function
static destructor

См. также