std::flush
来自 cppreference.cn
定义于头文件 <ostream> |
||
template< class CharT, class Traits > std::basic_ostream<CharT, Traits>& flush( std::basic_ostream<CharT, Traits>& os ); |
||
刷新输出序列 os,如同调用 os.flush() 一样。
这是一个仅输出 I/O 操纵符,可以用于诸如 out << std::flush 的表达式中,其中 out
的类型为 std::basic_ostream。
目录 |
[编辑] 注解
此操纵符可用于立即生成不完整的输出行,例如,当显示长时间运行的进程的输出、记录多个线程的活动或记录可能意外崩溃的程序的活动时。在调用 std::system 之前,显式刷新 std::cout 也是必要的,如果派生的进程执行任何屏幕 I/O(一个常见的例子是 Windows 上的 std::system("pause"))。在大多数其他常见的交互式 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> 的公共成员函数) |