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

basic_ostream& flush();

Записывает незафиксированные изменения в базовую выходную последовательность. Работает как неформатированная функция вывода.

Если rdbuf() является нулевым указателем, объект sentry не создаётся.

В противном случае после создания и проверки объекта sentry вызывает rdbuf()->pubsync(). Если вызов возвращает -1, вызывает setstate(badbit).

Возвращаемое значение

*this

Исключения

Может выбросить std::ios_base::failure, если (exceptions() & badbit) != 0.

Пример

#include <chrono>
#include <iostream>
#include <thread>

using namespace std::chrono_literals;

void f()
{
    std::cout << "Output from thread... ";
    for (int i{1}; i != 10; ++i)
    {
        std::this_thread::sleep_for(250ms);
        std::cout << i << ' ';
        
        // output three numbers at once;
        // the effect is observable only in real-time
        if (0 == (i % 3))
            std::cout.flush();
    }
    std::cout << std::endl; // flushes as well
}

int main()
{
    std::thread tr{f};
    std::this_thread::sleep_for(150ms);
    std::clog << "Output from main\n";
    tr.join();
}

Вывод:

Output from main
Output from thread... 1 2 3 4 5 6 7 8 9

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

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

DR	Применяется к	Опубликованное поведение	Корректное поведение
LWG 581	C++98	`flush()` не работала как неформатированная функция вывода из-за решения проблемы LWG 60	работает как неформатированная функция вывода

См. также

pubsync	вызывает `sync()` (открытая функция-член `std::basic_streambuf<CharT,Traits>`)
sync [виртуальная]	синхронизирует буферы со связанной последовательностью символов (виртуальная защищённая функция-член `std::basic_streambuf<CharT,Traits>`)
flush	сбрасывает выходной поток (шаблон функции)
endl	выводит `'\n'` и сбрасывает выходной поток (шаблон функции)
sync	синхронизируется с базовым устройством хранения (открытая функция-член `std::basic_istream<CharT,Traits>`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/basic_ostream/flush