std::strstreambuf

 

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::strstreambuf

公開成員函式

strstreambuf::strstreambuf

strstreambuf::~strstreambuf

strstreambuf::freeze

strstreambuf::str

strstreambuf::pcount

受保護的成員函式

strstreambuf::underflow

strstreambuf::pbackfail

strstreambuf::overflow

strstreambuf::setbuf

strstreambuf::seekoff

strstreambuf::seekpos

 

定義於標頭檔案 <strstream>
class strstreambuf : public std::basic_streambuf<char>		(C++98 起棄用) (C++26 中移除)

std::strstreambuf 是一個 std::basic_streambuf，其關聯字元序列是一個字元陣列，該陣列可以是常量（例如字串字面量）、可修改但非動態（例如棧分配的陣列），或動態的。如果是動態陣列，std::strstreambuf 可以在必要時重新分配陣列以適應輸出（例如透過呼叫 delete[] 和 new[] 或使用者提供的函式）。

std::strstreambuf 的典型實現包含四個私有資料成員

1) 緩衝區狀態，一個位掩碼型別，可以表示“已分配”（解構函式將釋放）、“常量”（不允許輸出）、“動態”（輸出可能重新分配）或“凍結”（不允許釋放和重新分配）這四個值的任意組合

2) 已分配緩衝區大小（緩衝區的起始地址不需要特殊的資料成員，它可以儲存在繼承的指標 eback() 中）

3) 指向使用者提供的分配函式的指標

4) 指向使用者提供的釋放函式的指標。

注意

在對具有動態緩衝區的流呼叫 str() 後，需要呼叫 freeze(false)，以允許 strstreambuf 解構函式在必要時釋放緩衝區。

strstreambuf 自 C++98 起已被廢棄，並自 C++26 起被移除。推薦的替代方案是 std::spanbuf(自 C++23 起)。

成員函式

公開成員函式
(建構函式)	構造一個 strstreambuf 物件 (public 成員函式)
(解構函式) [虛]	銷燬一個 strstreambuf 物件，可選地釋放字元陣列 (虛 public 成員函式)
freeze	設定/清除緩衝區的凍結狀態 (public 成員函式)
str	將緩衝區標記為凍結並返回輸入序列的起始指標 (public 成員函式)
pcount	返回輸出序列中下一個指標減去起始指標的結果：已寫入字元的數量 (public 成員函式)
受保護的成員函式
underflow [虛]	從輸入序列中讀取一個字元，但不推進下一個指標 (虛 protected 成員函式)
pbackfail [虛]	將輸入序列回退以取消獲取一個字元 (虛 protected 成員函式)
overflow [虛]	向輸出序列追加一個字元，如果緩衝區是動態且未凍結的，則可能重新分配或初始分配緩衝區 (虛 protected 成員函式)
setbuf [虛]	嘗試用陣列替換受控字元序列 (虛 protected 成員函式)
seekoff [虛]	使用相對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (虛 protected 成員函式)
seekpos [虛]	使用絕對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (虛 protected 成員函式)

繼承自 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 成員函式)