命名空间
变体
操作

std::strstreambuf

来自 cppreference.com
< cpp‎ | io
 
C++
 
输入/输出库
 
std::strstreambuf
 
在头文件 <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) 已分配的缓冲区大小（缓冲区的开头不需要特殊的 data 成员，它可以存储在继承的指针 eback() 中）
3) 指向用户提供的分配函数的指针
4) 指向用户提供的释放函数的指针。

内容

[编辑] 说明

在对具有动态缓冲区的流进行任何调用 str() 后，需要调用 freeze(false) 以允许 strstreambuf 析构函数在必要时释放缓冲区。

strstreambuf 自 C++98 起已弃用，自 C++26 起已删除. 建议的替代方法是 std::spanbuf(自 C++23 起).

[编辑] 成员函数

公共成员函数

 构造一个 strstreambuf 对象
(公共成员函数) [编辑]
[虚函数]
 析构一个 strstreambuf 对象，可以选择释放字符数组
(虚拟公共成员函数) [编辑]
 设置/清除缓冲区的冻结状态
(公共成员函数) [编辑]
 标记缓冲区为冻结并返回输入序列的起始指针
(公共成员函数) [编辑]
 返回输出序列中下一个指针减去起始指针：写入的字符数
(公共成员函数) [编辑]

受保护的成员函数

[虚函数]
 从输入序列中读取一个字符，但不推进下一个指针
(虚拟受保护的成员函数) [编辑]
[虚函数]
 退回到输入序列以取消获取一个字符
(虚拟受保护的成员函数) [编辑]
[虚函数]
 将一个字符追加到输出序列，如果它是动态的且未冻结，则可能会重新分配或最初分配缓冲区
(虚拟受保护的成员函数) [编辑]
[虚函数]
 尝试用一个数组替换受控字符序列
(虚拟受保护的成员函数) [编辑]
[虚函数]
 使用相对寻址重新定位输入序列、输出序列或二者的下一个指针
(虚拟受保护的成员函数) [编辑]
[虚函数]
 使用绝对寻址重新定位输入序列、输出序列或二者的下一个指针
(虚拟受保护的成员函数) [编辑]

从 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> 的虚拟受保护成员函数) [编辑]
取自 "https://cppreference.cn/mwiki/index.php?title=cpp/io/strstreambuf&oldid=170661"