std::strstreambuf::strstreambuf
< cpp | io | strstreambuf
(1) | ||
explicit strstreambuf( std::streamsize alsize = 0 ); |
(C++11 前) | |
strstreambuf() : strstreambuf(0) {} explicit strstreambuf( std::streamsize alsize ); |
(C++11 起) | |
strstreambuf( void* (*palloc)(std::size_t), void (*pfree)(void*) ); |
(2) | |
strstreambuf( char* gnext, std::streamsize n, char* pbeg = 0 ); |
(3) | |
strstreambuf( signed char* gnext, std::streamsize n, signed char* pbeg = 0 ); |
(4) | |
strstreambuf( unsigned char* gnext, std::streamsize n, unsigned char* pbeg = 0 ); |
(5) | |
strstreambuf( const char* gnext, std::streamsize n ); |
(6) | |
strstreambuf( const signed char* gnext, std::streamsize n); |
(7) | |
strstreambuf( const unsigned char* gnext, std::streamsize n ); |
(8) | |
1) 构造
std::strstreambuf
对象:通过调用 std::streambuf 的默认构造函数初始化基类,初始化缓冲状态为“动态”(将按需分配缓冲区),初始化已分配大小为提供的 alsize
,初始化分配和解分配函数为空值(将使用 new[] 与 delete[] )。2) 构造
std::strstreambuf
对象:通过调用 std::streambuf 的默认构造函数初始化基类,初始化缓冲状态为“动态”(将按需分配缓冲区),初始化已分配大小为未指定值,初始化分配函数为 palloc
,解分配函数为 pfree
。3-5) 依下列步骤构造
std::strstreambuf
对象:a) 通过调用 std::streambuf 的默认构造函数初始化基类
b) 初始化缓冲状态为“冻结”(缓冲区为用户提供的固定大小缓冲区)
d) 以下列方式配置 std::basic_streambuf 的指针:若
pbeg
为空指针,则调用 setg(gnext, gnext, gnext + N) 。若 pbeg
不是空指针,则执行 setg(gnext, gnext, pbeg) 和 setp(pbeg, pbeg+N) ,其中 N 是之前确定的数组中的元素数。6-8) 同 strstreambuf((char*)gnext, n) ,除了在缓冲状态位掩码中设置“常量”(不允许输出到此缓冲区)。
参数
alsize | - | 动态分配的缓冲区的初始大小 |
palloc | - | 指向用户提供的分配函数的指针 |
pfree | - | 指向用户提供的解分配函数的指针 |
gnext | - | 指向用户提供的数组中获取区起始的指针 |
pbeg | - | 指向用户提供的数组中放置区起始的指针 |
n | - | 用户提供数组的获取区(若 pbeg 为空)或放置区(若 pbeg 非空)中的字节数 |
注意
这些构造函数常为 std::strstream 的构造函数所调用
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
P0935R0 | C++11 | 默认构造函数曾为 explicit | 使之为隐式 |
示例
运行此代码
#include <strstream> #include <iostream> int main() { std::strstreambuf dyn; // 动态 std::strstream dyn_s; // 等价的流 dyn_s << 1.23 << std::ends; std::cout << dyn_s.str() << '\n'; dyn_s.freeze(false); char buf[10]; std::strstreambuf user(buf, 10, buf); // 用户提供的输出缓冲区 std::ostrstream user_s(buf, 10); // 等价的流 user_s << 1.23 << std::ends; std::cout << buf << '\n'; std::strstreambuf lit("1 2 3", 5); // 常量 std::istrstream lit_s("1 2 3"); // 等价的流 int i, j, k; lit_s >> i >> j >> k; std::cout << i << ' ' << j << ' ' << k << '\n'; }
输出:
1.23 1.23 1 2 3
参阅
构造 strstream ,可选地分配缓冲区 ( std::strstream 的公开成员函数) |