std::basic_stringbuf
出自cppreference.com
| 在標頭 <sstream> 定義
|
||
| |
||
std::basic_stringbuf 是關聯字符序列為內存常駐的任意字符序列的 std::basic_streambuf。能從 std::basic_string 的實例初始化它,或將它做成 std::basic_string 的實例。
std::basic_stringbuf 的典型實現保有一個 std::basic_string 類型的對象,或等價的可伸縮序列容器作為數據成員,並將它同時用作受控制字符序列(為 std::basic_streambuf 的六個指針所指向的數組)和關聯字符序列(所有輸入操作的字符源和輸出操作的目標)。
另外,典型的實現保有一個 std::ios_base::openmode 類型的數據成員,以指示流的模式(只讀、只寫、讀寫、尾端寫等)。
|
如果 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 (僅用於闡述的成員對象*) |
| 初始化輸入和輸出序列 (僅用於闡述的成員函數*) |
公開成員函數
構造一個 basic_stringbuf 對象 (公開成員函數) | |
(C++11) |
賦值 basic_stringbuf 對象 (公開成員函數) |
(C++11) |
交換兩個 basic_stringbuf 對象 (公開成員函數) |
(析構函數) [虛] (隱式聲明) |
析構 basic_stringbuf 對象和它保有的字符串 (虛公開成員函數) |
| 替換或獲得關聯字符串的副本 (公開成員函數) | |
(C++20) |
獲得與內部序列容器關聯的分配器的副本 (公開成員函數) |
(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
|
成員函數
[虛] |
析構 basic_streambuf 對象 ( std::basic_streambuf<CharT,Traits> 的虛公開成員函數)
|
本地環境 | |
改換關聯的本地環境並調用 imbue() ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
| 獲得關聯的本地環境的副本 ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
尋位 | |
調用 setbuf() ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
調用 seekoff() ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
調用 seekpos() ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
調用 sync() ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
獲取區 | |
| 獲得獲取區中立即可用的字符數 ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
| 推進輸入序列,然後讀取一個字符而不再推進 ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
(C++17 移除) |
從輸入序列讀取一個字符並令序列前進 ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
|
| 從輸入序列讀取一個字符,而不推進序列 ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
調用 xsgetn() ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
放置區 | |
| 寫一個字符到放置區域,並推進下一位置指針 ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
調用 xsputn() ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
回放 | |
| 在輸入序列中放回一個字符 ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
| 回移一位輸出序列中的下一位置指針 ( std::basic_streambuf<CharT,Traits> 的公開成員函數)
| |
受保護成員函數
構造 basic_streambuf 對象 (受保護成員函數) | |
(C++11) |
替換 basic_streambuf 對象 (受保護成員函數) |
(C++11) |
交換兩個 basic_streambuf 對象 (受保護成員函數) |
本地環境 | |
[虛] |
響應關聯本地環境的更改 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
尋位 | |
[虛] |
(在允許時)以用戶定義數組替換緩衝區 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
[虛] |
用相對尋址重定位輸入序列、輸出序列或兩者中的下一位置指針 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
[虛] |
用絕對尋址重定位輸入序列、輸出序列或兩者中的下一位置指針 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
[虛] |
將緩衝與關聯的字符序列同步 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
獲取區 | |
[虛] |
獲得關聯輸入序列中可用於輸入的字符數(如果已知) ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
[虛] |
從關聯輸入序列讀取字符到獲取區 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
[虛] |
從輸入序列讀取字符到獲取區,並推進下一位置指針 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
[虛] |
從輸入序列讀取多個字符 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
| 返回指向獲取區起始、當前字符和末尾的指針 (受保護成員函數) | |
| 推進輸出序列中的下一位置指針 (受保護成員函數) | |
| 重定位輸入序列的起始、下一位置和終止指針 (受保護成員函數) | |
放置區 | |
[虛] |
將多個字符寫到輸出序列 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
[虛] |
從放置區寫入字符到關聯的輸出序列 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|
| 返回指向放置區的起始、當前字符和末尾的指針 (受保護成員函數) | |
| 推進輸出序列中的下一位置指針 (受保護成員函數) | |
| 重定位輸出序列的起始、下一位置和終止指針 (受保護成員函數) | |
回放 | |
[虛] |
將字符放回輸入序列,可能修改輸入序列 ( std::basic_streambuf<CharT,Traits> 的虛受保護成員函數)
|