std::basic_spanbuf

 

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_spanbuf

公開成員函式

basic_spanbuf::basic_spanbuf (C++23)

basic_spanbuf::operator= (C++23)

basic_spanbuf::swap (C++23)

basic_spanbuf::span (C++23)

受保護的成員函式

basic_spanbuf::setbuf (C++23)

basic_spanbuf::seekoff (C++23)

basic_spanbuf::seekpos (C++23)

非成員函式

swap(std::basic_spanbuf) (C++23)

 

定義於標頭檔案 <spanstream>
template<     class CharT,     class Traits = std::char_traits<CharT> > class basic_spanbuf     : public std::basic_streambuf<CharT, Traits>		(C++23 起)

std::basic_spanbuf 是 std::basic_streambuf，其關聯字元序列是記憶體駐留的任意字元序列，可以從 std::span<CharT> 例項初始化或提供為該例項。

std::basic_spanbuf 在固定緩衝區上執行 I/O，因此當底層緩衝區耗盡時，它不會嘗試獲取新緩衝區。

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

定義於標頭檔案 <spanstream>
型別	定義
std::spanbuf	std::basic_spanbuf<char>
std::wspanbuf	std::basic_spanbuf<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

資料成員

成員名稱 (Member name)	定義
mod (私有)	記錄開啟模式的 std::ios_base::openmode。 (僅用於闡釋的成員物件*)
buf (私有)	引用底層緩衝區的 std::span<CharT>。 (僅用於闡釋的成員物件*)

成員函式

公開成員函式
(建構函式)	構造 basic_spanbuf 物件 (public 成員函式)
(解構函式) [虛]	銷燬 basic_spanbuf 物件 (虛公共成員函式)
operator=	賦值 basic_spanbuf 物件 (public 成員函式)
swap	交換兩個 basic_spanbuf 物件 (public 成員函式)
span	根據模式獲取或初始化底層緩衝區 (public 成員函式)
受保護的成員函式
setbuf [虛]	嘗試用陣列替換受控字元序列 (virtual protected 成員函式)
seekoff [虛]	使用相對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (virtual protected 成員函式)
seekpos [虛]	使用絕對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (virtual protected 成員函式)

非成員函式

std::swap(std::basic_spanbuf) (C++23)

特化 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

成員函式

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

受保護的成員函式

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

註釋

std::basic_spanbuf 不擁有底層緩衝區。

程式設計師有責任確保底層緩衝區在使用 std::basic_spanbuf 物件時處於其生命週期內。如果多個執行緒透過不同的 std::basic_spanbuf 物件操作相同的底層緩衝區，可能需要額外的同步。

特性測試宏	值	標準	特性
__cpp_lib_spanstream	202106L	(C++23)	std::spanbuf, std::spanstream

另請參閱

basic_stringbuf	實現原始字串裝置 (類模板)
strstreambuf (在 C++98 中已廢棄)(在 C++26 中已移除)	實現原始字元陣列裝置 (類)