std::flush

 

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>& flush( std::basic_ostream<CharT, Traits>& os );

重新整理輸出序列 os，如同呼叫 os.flush()。

這是一個僅用於輸出的 I/O 運算子，它可以與表示式一起呼叫，例如對於 std::basic_ostream 型別的任何 out，可以使用 out << std::flush。

注意

此運算子可用於立即產生不完整的輸出行，例如在顯示長時間執行程序的輸出、記錄多個執行緒的活動或記錄可能意外崩潰的程式的活動時。在呼叫 std::system 之前，如果生成的程序執行任何螢幕 I/O（一個常見的例子是 Windows 上的 std::system("pause")），則還需要顯式重新整理 std::cout。在大多數其他常見的互動式 I/O 場景中，當與 std::cout 一起使用時，std::endl 是多餘的，因為來自 std::cin 的任何輸入、輸出到 std::cerr 或程式終止都會強制呼叫 std::cout.flush()。

當需要重新整理完整的輸出行時，可以使用 std::endl 運算子。

當每個輸出操作都需要重新整理時，可以使用 std::unitbuf 運算子。

引數

os

-

輸出流的引用

返回值

os（操作後的流的引用）。

示例

沒有 std::flush，輸出將是相同的，但可能不會即時顯示。

執行此程式碼

#include <chrono>
#include <iostream>
 
template<typename Diff>
void log_progress(Diff d)
{
    std::cout << std::chrono::duration_cast<std::chrono::milliseconds>(d) << " ... "
              << std::flush;
}
 
int main()
{
    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; // do some work
        auto now = std::chrono::high_resolution_clock::now();
        log_progress(now - t1);
    }
    std::cout << '\n';
}

可能的輸出

567ms ... 1137ms ... 1707ms ... 2269ms ... 2842ms ...

另請參閱

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