定义于头文件 <sstream>

template<     class CharT,     class Traits = std::char_traits<CharT> > class basic_stringstream;		(C++11 前)
template<     class CharT,     class Traits = std::char_traits<CharT>,     class Allocator = std::allocator<CharT> > class basic_stringstream;		(C++11 起)

类模板 std::basic_stringstream 实现基于字符串的流上的输入与输出操作。它等效地存储一个 std::basic_string 的实例，并在其上进行输入与输出操作。

在低层，该类实际上包装 std::basic_stringbuf 的未处理字符串设备到 std::basic_iostream 的高层接口中。提供到独有 std::basic_stringbuf 成员的完整接口。

亦为常用字符类型定义二个特化：

类型	定义
stringstream	basic_stringstream<char>
wstringstream	basic_stringstream<wchar_t>

成员函数

移动字符串流

std::basic_stringstream::operator=

basic_stringstream& operator=( basic_stringstream&& other );

(C++11 起)

移动赋值字符串流 other 给 *this ，等效的移动赋值 std::basic_iostream 基类和关联的 std::basic_stringbuf 。

注意，基类移动赋值交换 *this 与 other 间的所有流状态变量（除了 rdbuf ）。

参数

other

-

移动来源的字符串流

返回值

*this

 调用示例

#include <sstream>
#include <string>
#include <iostream>

int main()
{
    //3) 以 str 的副本为底层字符串设备的初始内容。
    std::string string1 = "I am a handsome programmer";
    std::basic_stringstream<char>
    basic_stringstream1(string1, std::ios_base::in | std::ios_base::out);
    std::cout << "basic_stringstream1: "
              << basic_stringstream1.str() << std::endl;
    std::cout << "rdstate: " << basic_stringstream1.rdstate() << std::endl;

    std::string string2 = "I am a super handsome guy";
    std::basic_stringstream<char>
    basic_stringstream2(string2, std::ios_base::in | std::ios_base::out);
    std::cout << "basic_stringstream2: "
              << basic_stringstream2.str() << std::endl;
    basic_stringstream2.setstate(std::ios_base::badbit);
    std::cout << "rdstate: " << basic_stringstream2.rdstate() << std::endl;

    return 0;
}

输出

返回底层未处理的字符串设备对象

std::basic_stringstream::rdbuf

std::basic_stringbuf<CharT, Traits, Allocator>* rdbuf() const;

返回指向底层未处理字符串设备对象的指针。

参数

（无）

返回值

指向底层未处理字符串设备对象的指针。

调用示例

int main()
{
    //3) 以 str 的副本为底层字符串设备的初始内容。
    std::string string1 = "I am a handsome programmer";
    std::basic_stringstream<char>
    basic_stringstream1(string1, std::ios_base::in | std::ios_base::out);
    std::cout << "basic_stringstream1: " << basic_stringstream1.str() << std::endl;
    //返回指向底层未处理字符串设备对象的指针。
    std::cout << "basic_stringstream1: "
              << static_cast<void*>(basic_stringstream1.rdbuf()) << std::endl;

    return 0;
}

输出

字符串操作

获取或设置底层字符串设备对象的内容

std::basic_stringstream<CharT,Traits,Allocator>::str

std::basic_string<CharT,Traits,Allocator> str() const;	(1)
void str(const std::basic_string<CharT,Traits,Allocator>& new_str);	(2)

管理底层字符串对象的内容。

1) 返回底层字符串的副本，如同通过调用 rdbuf()->str() 。

2) 替换底层字符串，如同通过调用 rdbuf()->str(new_str) 。

参数

new_str

-

底层字符串的新内容

返回值

1) 底层字符串对象的副本。

2) （无）

注意

str 所返回的底层字符串副本是将于表达式结尾析构的临时对象，故在 str() 的结果上直接调用 c_str() （例如 auto *ptr = out.str().c_str(); 中）导致悬垂指针。

 调用示例

int main()
{
    //3) 以 str 的副本为底层字符串设备的初始内容。
    std::string string1 = "I am a handsome programmer";
    std::basic_stringstream<char>
    basic_stringstream1(string1, std::ios_base::in | std::ios_base::out);
    //1) 返回底层字符串的副本，如同通过调用 rdbuf()->str() 。
    std::cout << "basic_stringstream1: "
              << basic_stringstream1.str() << std::endl;

    //2) 替换底层字符串，如同通过调用 rdbuf()->str(new_str) 。
    std::string string2 = "I am a super handsome guy";
    basic_stringstream1.str(string2);
    std::cout << "basic_stringstream1: "
              << basic_stringstream1.str() << std::endl;

    return 0;
}

输出