std:: basic_stringbuf
|
定义于头文件
<sstream>
|
||
|
template
<
class
CharT,
|
||
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() 采用超额分配策略，则可能存储额外的高水位指针以追踪最后初始化的字符。 |
(since C++11) |
提供了几种常见字符类型的类型定义：
|
定义于头文件
<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)
|
获取底层字符序列的视图
(公开成员函数) |
受保护成员函数
|
[virtual]
|
返回输入序列中的下一个可用字符
（虚函数保护成员函数） |
|
[virtual]
|
将字符放回输入序列
（虚函数保护成员函数） |
|
[virtual]
|
向输出序列追加字符
（虚函数保护成员函数） |
|
[virtual]
|
尝试用数组替换受控字符序列
（虚函数保护成员函数） |
|
[virtual]
|
使用相对寻址重新定位输入序列、输出序列或两者中的下一个指针
（虚函数保护成员函数） |
|
[virtual]
|
使用绝对寻址重新定位输入序列、输出序列或两者中的下一个指针
（虚函数保护成员函数） |
非成员函数
|
(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
|
成员函数
|
[虚函数]
|
析构
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
对象
(受保护的成员函数) |
区域设置 |
|
|
[virtual]
|
响应关联区域设置的更改
（
std::basic_streambuf<CharT,Traits>
的虚保护成员函数）
|
定位 |
|
|
[virtual]
|
若允许则用用户自定义数组替换缓冲区
(
std::basic_streambuf<CharT,Traits>
的虚保护成员函数)
|
|
[virtual]
|
使用相对寻址重新定位输入序列、输出序列或两者中的下一个指针
（
std::basic_streambuf<CharT,Traits>
的虚受保护成员函数）
|
|
[virtual]
|
使用绝对寻址重新定位输入序列、输出序列或两者中的下一个指针
(
std::basic_streambuf<CharT,Traits>
的虚保护成员函数)
|
|
[virtual]
|
同步缓冲区与关联的字符序列
（
std::basic_streambuf<CharT,Traits>
的虚受保护成员函数）
|
获取面积 |
|
|
[virtual]
|
获取关联输入序列中可供输入的字符数量（若已知）
（
std::basic_streambuf<CharT,Traits>
的虚受保护成员函数）
|
|
[virtual]
|
从关联的输入序列读取字符到获取区域
（
std::basic_streambuf<CharT,Traits>
的虚受保护成员函数）
|
|
[virtual]
|
从关联输入序列读取字符到获取区并推进下一个指针
（
std::basic_streambuf<CharT,Traits>
的虚保护成员函数）
|
|
[virtual]
|
从输入序列读取多个字符
（
std::basic_streambuf<CharT,Traits>
的虚保护成员函数）
|
|
返回指向获取区域起始位置、当前字符和末尾的指针
（受保护的成员函数） |
|
|
推进输入序列中的下一个指针
(受保护成员函数) |
|
|
重新定位输入序列的起始指针、下一个指针和结束指针
(受保护成员函数) |
|
放置区域 |
|
|
[virtual]
|
向输出序列写入多个字符
（
std::basic_streambuf<CharT,Traits>
的虚保护成员函数）
|
|
[virtual]
|
将字符从放置区写入到关联的输出序列
(
std::basic_streambuf<CharT,Traits>
的虚保护成员函数)
|
|
返回指向输出区域起始位置、当前字符和末尾的指针
（受保护的成员函数） |
|
|
推进输出序列的下一指针
(受保护成员函数) |
|
|
重新定位输出序列的起始指针、下一个指针和结束指针
（受保护成员函数） |
|
Putback |
|
|
[virtual]
|
将字符放回输入序列，可能修改输入序列
(
std::basic_streambuf<CharT,Traits>
的虚保护成员函数)
|