std::basic_stringbuf

 

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_stringbuf

公開成員函式

basic_stringbuf::basic_stringbuf

basic_stringbuf::operator= (C++11)

basic_stringbuf::swap (C++11)

basic_stringbuf::str

basic_stringbuf::get_allocator (C++20)

basic_stringbuf::view (C++20)

受保護的成員函式

basic_stringbuf::underflow

basic_stringbuf::pbackfail

basic_stringbuf::overflow

basic_stringbuf::setbuf

basic_stringbuf::seekoff

basic_stringbuf::seekpos

非成員函式

swap(std::basic_stringbuf) (C++11)

僅用於說明的成員函式

basic_stringbuf::init_buf_ptrs

 

定義於標頭檔案 <sstream>
template<     class CharT,     class Traits = std::char_traits<CharT>,     class Allocator = std::allocator<CharT> > class basic_stringbuf     : public std::basic_streambuf<CharT, Traits>

std::basic_stringbuf 是 std::basic_streambuf，其關聯字元序列是記憶體中的任意字元序列，可以從 std::basic_string 的例項初始化或作為其例項提供。

std::basic_stringbuf 的典型實現將型別為 std::basic_string 或等效的可變大小序列容器物件直接作為資料成員，並將其用作受控字元序列（std::basic_streambuf 的六個指標所指向的陣列）和關聯字元序列（所有輸入操作的字元源和輸出的目標）。

此外，典型實現還包含一個型別為 std::ios_base::openmode 的資料成員，用於指示關聯流的 I/O 模式（僅輸入、僅輸出、輸入/輸出、在末尾等）。

如果 overflow() 使用過度分配策略，則可以儲存額外的“高水位”指標以跟蹤最後一個已初始化的字元。

(C++11 起)

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

定義於標頭檔案 <sstream>
型別	定義
std::stringbuf	std::basic_stringbuf<char>
std::wstringbuf	std::basic_stringbuf<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

僅用於說明的成員

buf	用作底層緩衝區的 std::basic_string<CharT, Traits, Allocator> (僅用於闡釋的成員物件*)
mode	關聯流的 std::ios_base::openmode (僅用於闡釋的成員物件*)
init_buf_ptrs	初始化輸入和輸出序列 (僅用於說明的成員函式*)

公有成員函式

(建構函式)	構造 basic_stringbuf 物件 (公有成員函式)
operator= (C++11)	賦值一個 basic_stringbuf 物件 (公有成員函式)
swap (C++11)	交換兩個 basic_stringbuf 物件 (公有成員函式)
(解構函式) [virtual] (隱式宣告)	銷燬 basic_stringbuf 物件及其持有的字串 (虛公有成員函式)
str	替換或獲取關聯字元字串的副本 (公有成員函式)
get_allocator (C++20)	獲取與內部序列容器關聯的分配器的副本 (公有成員函式)
view (C++20)	獲取底層字元序列的檢視 (公有成員函式)

受保護的成員函式

underflow [virtual]	返回輸入序列中下一個可用的字元 (虛受保護成員函式)
pbackfail [virtual]	將一個字元放回輸入序列 (虛受保護成員函式)
overflow [virtual]	將一個字元附加到輸出序列 (虛受保護成員函式)
setbuf [virtual]	嘗試用陣列替換受控字元序列 (虛受保護成員函式)
seekoff [virtual]	使用相對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (虛受保護成員函式)
seekpos [virtual]	使用絕對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (虛受保護成員函式)

非成員函式

std::swap(std::basic_stringbuf) (C++11)

特化 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 物件 (受保護成員函式)
operator= (C++11)	替換 basic_streambuf 物件 (受保護成員函式)
swap (C++11)	交換兩個 basic_streambuf 物件 (受保護成員函式)
區域設定
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	返回獲取區起始、當前字元和結尾的指標 (受保護成員函式)
gbump	推進輸入序列中的下一個指標 (受保護成員函式)
setg	重新定位輸入序列的起始、下一個和結束指標 (受保護成員函式)
放置區
xsputn [virtual]	向輸出序列寫入多個字元 (std::basic_streambuf<CharT,Traits> 的虛受保護成員函式)
overflow [virtual]	從放置區向關聯輸出序列寫入字元 (std::basic_streambuf<CharT,Traits> 的虛受保護成員函式)
pbasepptrepptr	返回放置區起始、當前字元和結尾的指標 (受保護成員函式)
pbump	推進輸出序列的下一個指標 (受保護成員函式)
setp	重新定位輸出序列的起始、下一個和結束指標 (受保護成員函式)
回放
pbackfail [virtual]	將一個字元放回輸入序列，可能會修改輸入序列 (std::basic_streambuf<CharT,Traits> 的虛受保護成員函式)