C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 输入/输出操纵符
- std::showpoint, std::noshowpoint
- std::setprecision
- std::fixed, std::scientific, std::hexfloat, std::defaultfloat
- std::setbase
- std::showbase, std::noshowbase
- std::quoted
- std::boolalpha, std::noboolalpha
- std::dec, std::hex, std::oct
- std::setfill
- std::setw
- std::left, std::right, std::internal
- std::showpos, std::noshowpos
- std::uppercase, std::nouppercase
- std::ws
- std::ends
- std::skipws, std::noskipws
- std::flush
- std::endl
- std::flush_emit
- std::unitbuf, std::nounitbuf
- std::emit_on_flush, std::no_emit_on_flush
- std::resetiosflags
- std::setiosflags
- std::get_money
- std::get_time
- std::put_money
- std::put_time
- C 风格文件输入/输出
- std::basic_streambuf
- std::basic_filebuf
- std::basic_stringbuf
- std::strstreambuf
- std::basic_syncbuf
- std::basic_ios
- std::basic_istream
- std::ios_base
- std::basic_osyncstream
- std::basic_ostream
- std::basic_iostream
- std::basic_ifstream
- std::basic_ofstream
- std::basic_fstream
- std::basic_istringstream
- std::basic_ostringstream
- std::basic_stringstream
- std::istrstream
- std::ostrstream
- std::strstream
- std::streamoff
- std::streamsize
- std::fpos
- std::iostream_category
- std::io_errc
- std::cin, std::wcin
- std::cout, std::wcout
- std::cerr, std::wcerr
- std::clog, std::wclog
- 注释
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::endl
定义于头文件 <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 操纵符,可对任何 std::basic_ostream 类型的 out
以表达式 out << std::endl 调用它。
注意
可用此操纵符立即产生新行的输出,例如在从长时间运行的进程显示输出、记录多个线程的活动或记录可能不期待地崩溃的程序活动时。在调用 std::system 前亦需要 std::cout 的显式冲入,若产生的进程进行任何屏幕 I/O 。多数其他通常的交互 I/O 场景中,使用 std::cout 时 std::endl
是冗余的,因为任何来自 std::cin 的输入、到 std::cerr 的输出或程序终止强制调用 std::cout.flush() 。某些源代码中鼓励用 std::endl
代替 '\n' ,这可能显著地降低输出性能。
多数实现中,标准输出是行缓冲的,而写入 '\n' 就会导致冲入,除非执行 std::ios::sync_with_stdio(false) 。这些情形中,不必要的 endl
只会降低文件输出的性能,而非标准输出的。
此维基上的代码示例遵循 Bjarne Stroustrup和《 C++ 核心方针》,只在需要时冲入标准输出。
需要冲入不完整的行时,可使用 std::flush 操纵符。
需要冲入每个字节的输出时,可使用 std::unitbuf 操纵符。
参数
os | - | 到输出流的引用 |
返回值
os
(到操纵后流的引用)
示例
以 \n 替代 endl ,输出会相同,但可能不会实时出现。
运行此代码
#include <iostream> #include <chrono> template<typename Diff> void log_progress(Diff d) { std::cout << std::chrono::duration_cast<std::chrono::milliseconds>(d).count() << " ms passed" << std::endl; } int main() { std::cout.sync_with_stdio(false); // 一些平台上 stdout 在写 \n 时冲入 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); } }
可能的输出:
487 ms passed 974 ms passed 1470 ms passed 1965 ms passed 2455 ms passed
参阅
控制是否每次操作后冲洗输出 (函数) | |
冲洗输出流 (函数模板) | |
与底层存储设备同步 ( std::basic_ostream<CharT,Traits> 的公开成员函数) |