std::basic_stringbuf

定义在头文件 `<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_string 实例提供。

std::basic_stringbuf 的典型实现直接将类型为 std::basic_string 或等效可调整大小序列容器的对象作为数据成员，并将其用作受控字符序列（std::basic_streambuf 的六个指针指向的数组）和关联字符序列（所有输入操作的字符源和输出的目标）。

此外，典型实现会保存类型为 std::ios_base::openmode 的数据成员，以指示关联流的 I/O 模式（仅输入、仅输出、输入/输出、在末尾等）。

如果 overflow() 使用超额分配策略，则可以存储额外的最高水位指针来跟踪最后初始化的字符。

(从 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 (仅供说明的成员对象*)
init_buf_ptrs	初始化输入和输出序列 (仅供说明的成员函数*)

[编辑] 公有成员函数

(构造函数)	构造 `basic_stringbuf` 对象 (公有成员函数) [编辑]
operator= (C++11)	分配 `basic_stringbuf` 对象 (公有成员函数) [编辑]
swap (C++11)	交换两个 `basic_stringbuf` 对象 (公有成员函数) [编辑]
(析构函数) [虚拟] (隐式声明)	析构 `basic_stringbuf` 对象及其持有的字符串 (虚拟公有成员函数) [编辑]
str	替换或获取关联字符字符串的副本 (公有成员函数) [编辑]
get_allocator (C++20)	获取与内部序列容器关联的分配器的副本 (公有成员函数) [编辑]
view (C++20)	获取底层字符序列的视图 (公有成员函数) [编辑]

[编辑] 保护成员函数

underflow [虚拟]	返回输入序列中可用的下一个字符 (虚拟保护成员函数) [编辑]
pbackfail [虚拟]	将一个字符放回输入序列 (虚拟保护成员函数) [编辑]
overflow [虚拟]	将一个字符追加到输出序列 (虚拟保护成员函数) [编辑]
setbuf [虚拟]	尝试用一个数组替换受控字符序列 (虚拟保护成员函数) [编辑]
seekoff [虚拟]	使用相对寻址方式重新定位输入序列、输出序列或两者的下一个指针 (虚拟保护成员函数) [编辑]
seekpos [虚拟]	使用绝对寻址方式重新定位输入序列、输出序列或两者的下一个指针 (虚拟保护成员函数) [编辑]

[编辑] 非成员函数

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`[编辑]

成员函数

(析构函数) [虚拟]	销毁 `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	获取 get 区域中立即可用的字符数量 (`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	将一个字符写入 put 区域并推进下一个指针 (`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 [虚拟]	更改关联区域设置 (`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>` 的虚拟保护成员函数) [编辑]
获取区域
showmanyc [虚拟]	获取关联输入序列中可用于输入的字符数量（如果已知） (`std::basic_streambuf<CharT,Traits>` 的虚拟保护成员函数) [编辑]
underflow [虚拟]	从关联的输入序列读取字符到 get 区域 (`std::basic_streambuf<CharT,Traits>` 的虚拟保护成员函数) [编辑]
uflow [虚拟]	从关联的输入序列读取字符到 get 区域并推进下一个指针 (`std::basic_streambuf<CharT,Traits>` 的虚拟保护成员函数) [编辑]
xsgetn [虚拟]	从输入序列读取多个字符 (`std::basic_streambuf<CharT,Traits>` 的虚拟保护成员函数) [编辑]
ebackgptregptr	返回指向 get 区域的开头、当前字符和结尾的指针 (受保护的成员函数) [编辑]
gbump	将输入序列中的下一个指针向前移动 (受保护的成员函数) [编辑]
setg	重新定位输入序列的开始、下一个和结束指针 (受保护的成员函数) [编辑]
放入区域
xsputn [虚拟]	将多个字符写入输出序列 (`std::basic_streambuf<CharT,Traits>` 的虚拟受保护成员函数) [编辑]
overflow [虚拟]	从输出区域将字符写入关联的输出序列 (`std::basic_streambuf<CharT,Traits>` 的虚拟受保护成员函数) [编辑]
pbasepptrepptr	返回指向输出区域的开始、当前字符和结束的指针 (受保护的成员函数) [编辑]
pbump	将输出序列的下一个指针向前移动 (受保护的成员函数) [编辑]
setp	重新定位输出序列的开始、下一个和结束指针 (受保护的成员函数) [编辑]
放回
pbackfail [虚拟]	将一个字符放回输入序列，可能会修改输入序列 (`std::basic_streambuf<CharT,Traits>` 的虚拟受保护成员函数) [编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (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)

公有成员函数
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

cppreference.com

命名空间

变体

视图

操作