定义于头文件 <sstream>

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

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

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

 亦定义对于常用字符类型的二个特化：

类型	定义
istringstream	basic_istringstream<char>
wistringstream	basic_istringstream<wchar_t>

成员函数

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

std::basic_istringstream::rdbuf

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

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

参数

（无）

返回值

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

调用示例

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

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

    return 0;
}

输出

 

字符串操作

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

std::basic_istringstream<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(); 中）导致悬垂指针。

调用示例

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

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

    return 0;
}

输出