命名空间
变体
操作

std::flush

来自 cppreference.cn
< cpp‎ | io‎ | manip
 
 
 
输入/输出操纵器
浮点格式化
整数格式化
布尔格式化
字段宽度和填充控制
其他格式化
空白字符处理
输出刷新
flush
(C++20)  

状态标志操作
时间与金钱 I/O
(C++11)
(C++11)
(C++11)
(C++11)
带引号的操纵器
(C++14)
 
定义于头文件 <ostream>
template< class CharT, class Traits >
std::basic_ostream<CharT, Traits>& flush( std::basic_ostream<CharT, Traits>& os );

刷新输出序列 os,如同调用 os.flush()

这是一个仅用于输出的 I/O 操作符,它可以与表达式一起调用,例如对于 std::basic_ostream 类型的任何 out,可以使用 out << std::flush

目录

[编辑] 注意

此操作符可用于立即产生不完整的输出行,例如在显示长时间运行进程的输出、记录多个线程的活动或记录可能意外崩溃的程序的活动时。在调用 std::system 之前,如果生成的进程执行任何屏幕 I/O(一个常见的例子是 Windows 上的 std::system("pause")),则还需要显式刷新 std::cout。在大多数其他常见的交互式 I/O 场景中,当与 std::cout 一起使用时,std::endl 是多余的,因为来自 std::cin 的任何输入、输出到 std::cerr 或程序终止都会强制调用 std::cout.flush()

当需要刷新完整的输出行时,可以使用 std::endl 操作符。

当每个输出操作都需要刷新时,可以使用 std::unitbuf 操作符。

[编辑] 参数

os - 输出流的引用

[编辑] 返回值

os(操作后的流的引用)。

[编辑] 示例

没有 std::flush,输出将是相同的,但可能不会实时显示。

#include <chrono>
#include <iostream>
 
template<typename Diff>
void log_progress(Diff d)
{
    std::cout << std::chrono::duration_cast<std::chrono::milliseconds>(d) << " ... "
              << std::flush;
}
 
int main()
{
    volatile int sink = 0;
 
    auto t1 = std::chrono::high_resolution_clock::now();
    for (int j = 0; j < 5; ++j)
    {
        for (int n = 0; n < 10000; ++n)
            for (int m = 0; m < 20000; ++m)
                sink += m * n; // do some work
        auto now = std::chrono::high_resolution_clock::now();
        log_progress(now - t1);
    }
    std::cout << '\n';
}

可能的输出

567ms ... 1137ms ... 1707ms ... 2269ms ... 2842ms ...

[编辑] 另请参阅

控制每次操作后是否刷新输出
(函数) [编辑]
输出 '\n' 并刷新输出流
(函数模板) [编辑]
与底层存储设备同步
(std::basic_ostream<CharT,Traits> 的公共成员函数) [编辑]