C++标准模板(STL)- 输入/输出操纵符-(std::endl)

操纵符是令代码能以 operator<< 或 operator>> 控制输入/输出流的帮助函数。

不以参数调用的操纵符(例如 std::cout << std::boolalpha; 或 std::cin >> std::hex; )实现为接受到流的引用为其唯一参数的函数。 basic_ostream::operator<< 和 basic_istream::operator>> 的特别重载版本接受指向这些函数的指针。这些函数(或函数模板的实例化)是标准库中仅有的可取址函数。 (C++20 起)

以参数调用的操纵符(例如 std::cout << std::setw(10); )实现为返回未指定类型对象的函数。这些操纵符定义其自身的进行请求操作的 operator<< 或 operator>> 。
 

输出 '\n' 并冲洗输出流

std::endl

template< class CharT, class Traits >
std::basic_ostream& endl( std::basic_ostream& 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 (到操纵后流的引用)

调用示例

#include 
#include 

template
void log_progress(Diff d)
{
    std::cout << std::chrono::duration_cast(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);
    }

    return 0;
}

输出

C++标准模板(STL)- 输入/输出操纵符-(std::endl)_第1张图片

你可能感兴趣的:(c++,标准库模板,输入/输出操纵符)