std::endl

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

I/O 操縱器

列印函式 (C++23)

C 風格 I/O

緩衝區

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

檔案 I/O

basic_ifstream

basic_ofstream

basic_fstream

字串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

陣列 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步輸出

basic_osyncstream (C++20)

型別

streamoff

streamsize

fpos

錯誤類別介面

iostream_category (C++11)

io_errc (C++11)

 

輸入/輸出操縱器

浮點格式化
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
整數格式化
setbase showbasenoshowbase	dechexoct
布林格式化
boolalphanoboolalpha
欄位寬度和填充控制
setfill setw	internalleftright
其他格式化
showposnoshowpos	uppercasenouppercase
空白字元處理
ws ends	skipwsnoskipws
輸出重新整理
flush endl flush_emit (C++20)	unitbufnounitbuf emit_on_flushnoemit_on_flush (C++20)(C++20)
狀態標誌操作
resetiosflags	setiosflags
時間與金錢 I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)
帶引號的操縱器
quoted (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 一起呼叫，其中 out 是 std::basic_ostream 型別。

注意

此運算子可用於立即生成一行輸出，例如，在顯示長時間執行程序的輸出、記錄多個執行緒的活動或記錄可能意外崩潰的程式的活動時。在呼叫 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 運算子。

引數

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

另請參閱

unitbufnounitbuf	控制每次操作後是否重新整理輸出 (函式)
flush	重新整理輸出流 (函式模板)
flush	與底層儲存裝置同步 (std::basic_ostream<CharT,Traits> 的公共成員函式)