std::endl
来自 cppreference.cn
| 定义于头文件 <ostream> |
||
| template< class CharT, class Traits > std::basic_ostream<CharT, Traits>& endl( std::basic_ostream<CharT, Traits>& os ); |
||
将换行符插入到输出序列 os 中，并刷新它，就像调用 os.put(os.widen('\n')) 后接着调用 os.flush() 一样。
这是一个仅用于输出的 I/O 操作符，它可以与表达式 out << std::endl 一起调用，其中 out 是 std::basic_ostream 类型。
目录 |
[edit] 注意
此操作符可用于立即生成一行输出，例如，在显示长时间运行进程的输出、记录多个线程的活动或记录可能意外崩溃的程序的活动时。在调用 std::system 之前，如果派生进程执行任何屏幕 I/O，则也需要显式刷新 std::cout。在大多数其他常见的交互式 I/O 场景中，当与 std::cout 一起使用时，std::endl 是多余的，因为来自 std::cin 的任何输入、输出到 std::cerr 或程序终止都会强制调用 std::cout.flush()。用 std::endl 代替 '\n'（某些来源鼓励这样做）可能会显著降低输出性能。
在许多实现中，标准输出是行缓冲的，写入 '\n' 无论如何都会导致刷新，除非执行了 std::ios::sync_with_stdio(false)。在这些情况下，不必要的 endl 只会降低文件输出的性能，而不是标准输出。
本 wiki 上的代码示例遵循 Bjarne Stroustrup 和 C++ 核心指南，仅在必要时刷新标准输出。
当需要刷新不完整的输出行时，可以使用 std::flush 操作符。
当需要刷新每个输出字符时，可以使用 std::unitbuf 操作符。
[edit] 参数
| os | - | 输出流的引用 |
[edit] 返回值
os（操作后的流的引用）。
[edit] 示例
用 '\n' 代替 endl，输出将是相同的，但可能不会实时显示。
运行此代码
#include <chrono> #include <iostream> template<typename Diff> void log_progress(Diff d) { std::cout << std::chrono::duration_cast<std::chrono::milliseconds>(d) << " passed" << std::endl; } int main() { std::cout.sync_with_stdio(false); // on some platforms, stdout flushes on \n static volatile int sink{}; const auto t1 = std::chrono::high_resolution_clock::now(); for (int i = 0; i < 5; ++i) { for (int j = 0; j < 10000; ++j) for (int k = 0; k < 20000; ++k) sink += i * j * k; // do some work log_progress(std::chrono::high_resolution_clock::now() - t1); } }
可能的输出
566ms passed 1133ms passed 1699ms passed 2262ms passed 2829ms passed
[edit] 另请参阅
| 控制每次操作后是否刷新输出 (函数) | |
| 刷新输出流 (函数模板) | |
| 与底层存储设备同步 ( std::basic_ostream<CharT,Traits> 的公共成员函数) |
