std::basic_syncbuf<CharT,Traits,Allocator>::emit

 

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)

 

std::basic_syncbuf

公開成員函式

basic_syncbuf::basic_syncbuf (C++20)

basic_syncbuf::operator= (C++20)

basic_syncbuf::~basic_syncbuf (C++20)

basic_syncbuf::swap (C++20)

basic_syncbuf::emit (C++20)

basic_syncbuf::get_wrapped (C++20)

basic_syncbuf::get_allocator (C++20)

basic_syncbuf::set_emit_on_sync (C++20)

受保護的成員函式

basic_syncbuf::sync (C++20)

非成員函式

swap(std::basic_syncbuf) (C++20)

 

bool emit();

原子地將所有待處理的輸出傳輸到被包裝的流。

所有將字元傳輸到同一被包裝流緩衝物件的 emit() 呼叫，表現為以一個總序執行，其中每個 emit() 呼叫與該總序中的後續 emit() 呼叫同步於（synchronizes-with），即使這些呼叫是透過 std::basic_syncbuf/std::basic_osyncstream 的不同例項進行的。實踐中，這意味著 emit() 獲取一個與被包裝流物件唯一關聯的鎖：例如，該鎖可以儲存在一個靜態雜湊表中，其中被包裝流的地址被用作鍵。

如果自上次呼叫 emit() 以來，曾呼叫過 sync，那麼還會透過在其上呼叫 pubsync() 來沖洗被包裝的流。

引數

(無)

返回值

若以下所有條件均為 true，則返回 true

• 存在一個被包裝的流（被包裝的 streambuf 指標不為空）
• 臨時儲存中的所有字元都成功傳送到被包裝的流中
• 對 pubsync() 的呼叫（如果請求）也成功完成。

否則返回 false。

注意

通常由所屬的 std::basic_osyncstream 的解構函式或移動賦值運算子呼叫，或由 std::basic_osyncstream::emit 呼叫。

參閱

(解構函式)	銷燬 basic_osyncstream 併發出其內部緩衝區 (std::basic_osyncstream<CharT,Traits,Allocator> 的公開成員函式)
emit	在底層的 basic_syncbuf 上呼叫 emit()，將其內部資料傳輸到最終目的地 (std::basic_osyncstream<CharT,Traits,Allocator> 的公開成員函式)
(建構函式)	構造 basic_syncbuf 物件 (公開成員函式)