std::unitbuf, std::nounitbuf

 

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)

 

定義於標頭檔案 <ios>
std::ios_base& unitbuf( std::ios_base& str );	(1)
std::ios_base& nounitbuf( std::ios_base& str );	(2)

在任何輸出操作後啟用或停用輸出流的自動重新整理。對輸入沒有影響。

1) 在流 str 中啟用 unitbuf 標誌，如同呼叫了 str.setf(std::ios_base::unitbuf)。

2) 在流 str 中停用 unitbuf 標誌，如同呼叫了 str.unsetf(std::ios_base::unitbuf)。

這是一個 I/O 操縱器，對於任何型別為 std::basic_ostream 的 out，可以透過表示式 out << std::unitbuf 來呼叫；對於任何型別為 std::basic_istream 的 in，可以透過表示式 in >> std::unitbuf 來呼叫。

注意

重新整理是在 std::basic_ostream::sentry 物件的解構函式中執行的，如果 str.flags() & std::ios_base::unitbuf 為 true，它會呼叫 str.rdbuf()->pubsync()。

標準輸出物件 std::cerr 和 std::wcerr 預設設定了 unitbuf 位。

引數

str

-

I/O 流的引用

返回值

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

示例

在沒有 std::unitbuf 或其他顯式重新整理的情況下，輸出相同，但不會即時顯示。

執行此程式碼

#include <chrono>
#include <iostream>
 
template<typename Diff>
void log_progress(Diff d)
{
    std::cout << std::chrono::duration_cast<std::chrono::milliseconds>(d)
              << " ... ";
}
 
int main()
{
    volatile int sink = 0;
    std::cout << std::unitbuf; // enable automatic flushing
 
    const auto start = 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
        log_progress(std::chrono::high_resolution_clock::now() - start);
    }
    std::cout << '\n';
}

輸出

571ms ... 1146ms ... 1722ms ... 2294ms ... 2865ms ...

參閱

flush	重新整理輸出流 (函式模板)
endl	輸出 '\n' 並重新整理輸出流 (函式模板)