std::basic_syncbuf

 

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)

 

定義於標頭檔案 <syncstream>
template<     class CharT,     class Traits = std::char_traits<CharT>,     class Allocator = std::allocator<CharT> > class basic_syncbuf : public std::basic_streambuf<CharT, Traits>		(C++20 起)

std::basic_syncbuf 是一個 std::basic_streambuf 的包裝器（在構造時以指標形式提供）。它在自己的內部緩衝區中累積輸出，並在銷燬時以及明確請求時原子地將其全部內容傳輸到被包裝的緩衝區，使得它們顯示為連續的字元序列。它保證沒有資料競爭，也沒有傳送到被包裝緩衝區的字元交錯，只要對同一緩衝區的其他所有輸出都透過（可能是不同的）std::basic_syncbuf 例項進行。

std::basic_syncbuf 的典型實現包含一個指向被包裝的 std::basic_streambuf 的指標，一個布林標誌指示緩衝區是否會在同步（flush）時將其內容傳輸到被包裝的緩衝區，一個布林標誌指示當策略不是在同步時發出（emit）時存在掛起的 flush，一個使用 Allocator（例如 std::string）的內部緩衝區，以及一個指向用於在多個訪問同一被包裝流緩衝區的執行緒之間同步發出操作的互斥鎖的指標（這些互斥鎖可能在一個雜湊對映中，以指向 std::basic_streambuf 物件的指標作為鍵）。

像其他 streambuf 類一樣，std::basic_syncbuf 通常只通過相應的流 std::osyncstream 訪問，而不是直接訪問。

提供了用於常見字元型別的幾個 typedef

定義於標頭檔案 <syncstream>
型別	定義
std::syncbuf	std::basic_syncbuf<char>
std::wsyncbuf	std::basic_syncbuf<wchar_t>

成員型別

成員型別	定義
char_type	CharT
traits_type	Traits；如果 Traits::char_type 不是 CharT，則程式格式錯誤。
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type
allocator_type	Allocator
streambuf_type	std::basic_streambuf<CharT, Traits>

成員函式

公開成員函式
(建構函式)	構造 basic_syncbuf 物件 (public 成員函式)
operator=	賦值 basic_syncbuf 物件 (public 成員函式)
swap	交換兩個 basic_syncbuf 物件 (public 成員函式)
(解構函式)	銷燬 basic_syncbuf 併發出其內部緩衝區 (public 成員函式)
emit	原子地將整個內部緩衝區傳輸到被包裝的 streambuf (public 成員函式)
get_wrapped	檢索被包裝的 streambuf 指標 (public 成員函式)
get_allocator	檢索此 basic_syncbuf 使用的分配器 (public 成員函式)
set_emit_on_sync	更改當前同步時發出策略 (public 成員函式)
受保護的成員函式
sync	根據當前同步時發出策略，要麼發出，要麼記錄掛起的 flush (public 成員函式)

非成員函式

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

特化 std::swap 演算法 (函式模板)

繼承自 std::basic_streambuf

成員型別

成員型別	定義
char_type	CharT
traits_type	Traits；如果 Traits::char_type 不是 CharT，則程式格式錯誤。
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

成員函式

(解構函式) [virtual]	銷燬 basic_streambuf 物件 (std::basic_streambuf<CharT,Traits> 的虛公有成員函式)
區域設定
pubimbue	更改關聯的區域設定並呼叫 imbue() (std::basic_streambuf<CharT,Traits> 的公有成員函式)
getloc	獲取關聯區域設定的副本 (std::basic_streambuf<CharT,Traits> 的公有成員函式)
定位
pubsetbuf	呼叫 setbuf() (std::basic_streambuf<CharT,Traits> 的公有成員函式)
pubseekoff	呼叫 seekoff() (std::basic_streambuf<CharT,Traits> 的公有成員函式)
pubseekpos	呼叫 seekpos() (std::basic_streambuf<CharT,Traits> 的公有成員函式)
pubsync	呼叫 sync() (std::basic_streambuf<CharT,Traits> 的公有成員函式)
獲取區
in_avail	獲取獲取區中立即可用的字元數 (std::basic_streambuf<CharT,Traits> 的公有成員函式)
snextc	推進輸入序列，然後讀取一個字元而不再次推進 (std::basic_streambuf<CharT,Traits> 的公有成員函式)
sbumpcstossc (C++17 中移除)	從輸入序列中讀取一個字元並推進序列 (std::basic_streambuf<CharT,Traits> 的公有成員函式)
sgetc	從輸入序列中讀取一個字元而不推進序列 (std::basic_streambuf<CharT,Traits> 的公有成員函式)
sgetn	呼叫 xsgetn() (std::basic_streambuf<CharT,Traits> 的公有成員函式)
放置區
sputc	將一個字元寫入放置區並推進下一個指標 (std::basic_streambuf<CharT,Traits> 的公有成員函式)
sputn	呼叫 xsputn() (std::basic_streambuf<CharT,Traits> 的公有成員函式)
回放
sputbackc	將一個字元放回輸入序列 (std::basic_streambuf<CharT,Traits> 的公有成員函式)
sungetc	將輸入序列中的下一個指標後退一個位置 (std::basic_streambuf<CharT,Traits> 的公有成員函式)

受保護的成員函式

(建構函式)	構造 basic_streambuf 物件 (protected 成員函式)
operator= (C++11)	替換 basic_streambuf 物件 (protected 成員函式)
swap (C++11)	交換兩個 basic_streambuf 物件 (protected 成員函式)
區域設定
imbue [virtual]	響應關聯區域設定的更改 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
定位
setbuf [virtual]	如果允許，用使用者定義的陣列替換緩衝區 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
seekoff [virtual]	使用相對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
seekpos [virtual]	使用絕對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
sync [virtual]	將緩衝區與關聯的字元序列同步 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
獲取區
showmanyc [virtual]	如果已知，獲取關聯輸入序列中可用於輸入的字元數 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
underflow [virtual]	從關聯輸入序列中讀取字元到獲取區 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
uflow [virtual]	從關聯輸入序列中讀取字元到獲取區並推進下一個指標 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
xsgetn [virtual]	從輸入序列中讀取多個字元 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
ebackgptregptr	返回獲取區起始、當前字元和結尾的指標 (protected 成員函式)
gbump	推進輸入序列中的下一個指標 (protected 成員函式)
setg	重新定位輸入序列的起始、下一個和結束指標 (protected 成員函式)
放置區
xsputn [virtual]	向輸出序列寫入多個字元 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
overflow [virtual]	從放置區向關聯輸出序列寫入字元 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
pbasepptrepptr	返回放置區起始、當前字元和結尾的指標 (protected 成員函式)
pbump	推進輸出序列的下一個指標 (protected 成員函式)
setp	重新定位輸出序列的起始、下一個和結束指標 (protected 成員函式)
回放
pbackfail [virtual]	將一個字元放回輸入序列，可能會修改輸入序列 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)

注意

特性測試宏	值	標準	特性
__cpp_lib_syncbuf	201803L	(C++20)	同步緩衝輸出流（std::syncbuf，std::osyncstream）和操縱符