定义于头文件 <sstream>
template< class CharT, | (C++11 前) | |
template< class CharT, | (C++11 起) |
类模板 std::basic_ostringstream
实现基于字符串的流上的输入与输出操作。它等效地存储一个 std::basic_string 的实例,并在其上进行输出操作。
在低层,该类实际上包装 std::basic_stringbuf 的未处理字符串设备到 std::basic_ostream 的高层接口中。提供到独有 std::basic_stringbuf
成员的完整接口。
亦定义对常用字符类型的二个特化:
类型 | 定义 |
ostringstream | basic_ostringstream<char> |
wostringstream | basic_ostringstream<wchar_t> |
成员类型
移动字符串流
std::basic_ostringstream::operator=
basic_ostringstream& operator=( basic_ostringstream&& other ); | (C++11 起) |
移动赋值字符串流 other
给 *this
,等效的移动赋值 std::basic_ostream 基类和关联的 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_ostringstream<char> basic_ostringstream1(string1, std::ios_base::out);
std::cout << "basic_ostringstream1: " << basic_ostringstream1.str() << std::endl;
std::cout << "rdstate: " << basic_ostringstream1.rdstate() << std::endl;
std::string string2 = "I am a super handsome guy";
std::basic_ostringstream<char> basic_ostringstream2(string2, std::ios_base::out);
std::cout << "basic_ostringstream2: " << basic_ostringstream2.str() << std::endl;
basic_ostringstream2.setstate(std::ios_base::badbit);
std::cout << "rdstate: " << basic_ostringstream2.rdstate() << std::endl;
return 0;
}
输出
返回底层未处理的字符串设备对象
std::basic_ostringstream::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_ostringstream<char> basic_ostringstream1(string1, std::ios_base::out);
std::cout << "basic_ostringstream1: " << basic_ostringstream1.str() << std::endl;
//返回指向底层未处理字符串设备对象的指针。
std::cout << "basic_ostringstream1: "
<< static_cast<void*>(basic_ostringstream1.rdbuf()) << std::endl;
return 0;
}
输出
字符串操作
获取或设置底层字符串设备对象的内容
std::basic_ostringstream<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_ostringstream<char> basic_ostringstream1(string1, std::ios_base::out);
//1) 返回底层字符串的副本,如同通过调用 rdbuf()->str() 。
std::cout << "basic_ostringstream1: " << basic_ostringstream1.str() << std::endl;
//2) 替换底层字符串,如同通过调用 rdbuf()->str(new_str) 。
std::string string2 = "I am a super handsome guy";
basic_ostringstream1.str(string2);
std::cout << "basic_ostringstream1: " << basic_ostringstream1.str() << std::endl;
return 0;
}
输出