std::flush

< 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.flush() 冲入输出序列 os

这是仅输出的 I/O 操纵符,可以用如 out << std::flush 的表达式对任何 std::basic_ostream 类型的 out 调用。

注意

此操纵符可用于立即产生输出的不完整行,例如在从长时间运行的进程显示输出、记录多个线程的活动或记录可能不期待地崩溃的程序活动时。若产生的进程进行任何屏幕 I/O 大量,则调用 std::system 前亦需要 std::cout 的显式冲入(常见例子为 Windows 上的 std::system("pause") )。多数其他通常的交互 I/O 场景中,使用 std::coutstd::endl 是冗余的,因为任何来自 std::cin 的输入、到 std::cerr 的输出或程序终止强制调用 std::cout.flush()

需要冲入完整行时,可使用 std::endl 操纵符。

每次输出操作都需要冲入时,可使用 std::unitbuf 操纵符。

参数

os - 到输出流的引用

返回值

os (到操纵后的流的引用)

示例

没有 std::flush ,输出相同,但可能不实时出现。

#include <iostream>
#include <chrono>
template<typename Diff>
void log_progress(Diff d)
{
    std::cout << "..("
              << std::chrono::duration_cast<std::chrono::milliseconds>(d).count()
              << " ms).." << 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; // 做一些工作
        auto now = std::chrono::high_resolution_clock::now();
        log_progress(now - t1);
    }
    std::cout << '\n';
}

可能的输出:

..(450 ms)....(901 ms)....(1350 ms)....(1800 ms)....(2250 ms)..

参阅

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