std::basic_stringbuf

来自cppreference.com
< cpp | io
 
C++
 
输入/输出库
 
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 类型的数据成员，以指示流的模式（只读、只写、读写、尾端写等）。

如果 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 对象和它保有的字符串
(虚公开成员函数) [编辑]
替换或获得关联字符串的副本
(公开成员函数)