命名空间
变体
操作

std::endl

来自 cppreference.com
< cpp‎ | io‎ | manip
 
 
 
输入/输出操作符
浮点格式化
整数格式化
布尔格式化
字段宽度和填充控制
其他格式化
空白处理
输出刷新
endl
(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>& endl( std::basic_ostream<CharT, Traits>& os );

将换行符插入到输出序列 os 中,并像调用 os.put(os.widen('\n')) 后跟 os.flush() 一样刷新它。

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

内容

[编辑] 备注

此操作符可用于立即生成一行输出,例如当显示来自长时间运行进程的输出、记录多个线程的活动或记录可能意外崩溃的程序的活动时。在调用 std::system 之前,还需要显式刷新 std::cout,如果生成的进程执行任何屏幕 I/O。在大多数其他常见交互式 I/O 场景中,当与 std::cout 一起使用时,std::endl 是冗余的,因为来自 std::cin 的任何输入、对 std::cerr 的输出或程序终止都会强制调用 std::cout.flush()。在 '\n' 处使用 std::endl,一些来源鼓励这样做,可能会严重降低输出性能。

在许多实现中,标准输出是行缓冲的,写入 '\n' 会导致刷新,除非执行了 std::ios::sync_with_stdio(false)。在这些情况下,不必要的 endl 只会降低文件输出的性能,而不是标准输出。

此维基上的代码示例遵循 Bjarne StroustrupC++ 核心准则,只在必要时刷新标准输出。

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

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

[编辑] 参数

os - 对输出流的引用

[编辑] 返回值

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

[编辑] 示例

使用 '\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

[编辑] 参见

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