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

将未提交的更改写入底层输出序列。行为表现为 UnformattedOutputFunction 。

如果 rdbuf() 是空指针，则不会构造哨兵对象。

否则，在构造并检查哨兵对象后，调用 rdbuf ( ) - > pubsync ( ) 。若调用返回 - 1 ，则调用 setstate ( badbit ) 。

返回值

* this

异常

若 ( exceptions ( ) & badbit ) ! = 0 ，则可能抛出 std::ios_base::failure 。

示例

#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 << ' ';
        // 一次性输出三个数字；
        // 该效果仅在实时环境中可观察
        if (0 == (i % 3))
            std::cout.flush();
    }
    std::cout << std::endl; // 同样会刷新缓冲区
}
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++标准。

参见