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

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 风格 I/O

缓冲

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98 中弃用)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98 中弃用)

ostrstream (C++98 中弃用)

strstream (C++98 中弃用)

同步的输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::basic_stringstream

成员函数

basic_stringstream::basic_stringstream

basic_stringstream::operator=

basic_stringstream::swap (C++11)

basic_stringstream::rdbuf

字符串操作

basic_stringstream::str

basic_stringstream::view (C++20)

非成员函数

swap(std::basic_stringstream) (C++11)

 

	(1)
explicit basic_stringstream( std::ios_base::openmode mode =                                  std::ios_base::in | std::ios_base::out );			(C++11 前)
explicit basic_stringstream( std::ios_base::openmode mode );			(C++11 起)
basic_stringstream()     : basic_stringstream(std::ios_base::in | std::ios_base::out) {}		(2)	(C++11 起)
explicit basic_stringstream     ( const std::basic_string<CharT, Traits, Allocator>& str,       std::ios_base::openmode mode =           std::ios_base::in | std::ios_base::out );		(3)
explicit basic_stringstream     ( std::basic_string<CharT, Traits, Allocator>&& str,       std::ios_base::openmode mode =           std::ios_base::in | std::ios_base::out );		(4)	(C++20 起)
basic_stringstream( std::ios_base::openmode mode, const Allocator& a );		(5)	(C++20 起)
template< class SAlloc > basic_stringstream( const std::basic_string<CharT, Traits, SAlloc>& str,                     std::ios_base::openmode mode, const Allocator& a );		(6)	(C++20 起)
template< class SAlloc > basic_stringstream( const std::basic_string<CharT, Traits, SAlloc>& str,                     const Allocator& a )     : basic_stringstream(str, std::ios_base::in | std::ios_base::out, a) {}		(7)	(C++20 起)
template< class SAlloc > explicit basic_stringstream     ( const std::basic_string<CharT, Traits, SAlloc>& str,       std::ios_base::openmode mode =           std::ios_base::in | std::ios_base::out );		(8)	(C++20 起)
template< class StringViewLike > explicit basic_stringstream     ( const StringViewLike& t,       std::ios_base::openmode mode =           std::ios_base::in | std::ios_base::out );		(9)	(C++26 起)
template< class StringViewLike > basic_stringstream( const StringViewLike& t,                     std::ios_base::openmode mode, const Allocator& a );		(10)	(C++26 起)
template< class StringViewLike > basic_stringstream( const StringViewLike& t, const Allocator& a );		(11)	(C++26 起)
basic_stringstream( basic_stringstream&& other );		(12)	(C++11 起)

构造新的字符串流。

给定

• base_type 为 std::basic_iostream<CharT, Traits>，
• buf_type 为 std::basic_stringbuf<CharT, Traits, Allocator>，

std::basic_iostream 基以及仅用于阐述的数据成员 sb 会按以下方式初始化。

重载	std::basic_iostream 基	sb
(1)	base_type(std::addressof(sb))	buf_type(mode)
(2)		buf_type(std::ios_base::in | std::ios_base::out)
(3)		buf_type(str, mode)
(4)		buf_type(std::move(str), mode)
(5)		buf_type(mode, a)
(6)		buf_type(str, mode, a)
(7)		buf_type(str, std::ios_base::in | std::ios_base::out, a)
(8)		buf_type(str, mode)
(9)	std::addressof(sb)	{t, mode, Allocator()}
(10)		{t, mode, a}
(11)		{t, std::ios_base::in | std::ios_base::out, a}
(12)	从 other 的 std::basic_iostream 基 移动构造	从 other.sb 移动构造

8) 此重载只有在std::is_same_v<SAlloc, Allocator> 是 false时才会参与重载决议。

9-11) 这些重载只有在std::is_convertible_v<const StringViewLike&, std::basic_string_view<CharT, Traits>> 是 true时才会参与重载决议。

参数

str	-	用于初始化字符串流内容的字符串
t	-	用于初始化字符串流内容的对象（可转换到 std::basic_string_view）
mode	-	指定流打开模式。它是位掩码类型 (BitmaskType) ，定义下列常量： 常量 解释 app 每次写入前寻位到流结尾 binary 以二进制模式打开 in 为读打开 out 为写打开 trunc 在打开时舍弃流的内容 ate 打开后立即寻位到流结尾 noreplace (C++23) 以独占模式打开
other	-	用作源的另一字符串流

注解

在短的循环中，例如在用于字符串转换时构造单次使用的 basic_stringstream 对象，开销可能显著高于调用 str() 并复用同一对象。

功能特性测试宏	值	标准	注释
__cpp_lib_sstream_from_string_view	202306L	(C++26)	字符串流的 std::string_view 接口，(9-11)

示例

运行此代码

#include <iostream>
#include <sstream>
 
int main()
{
    // 默认构造函数（输入/输出流）
    std::stringstream buf1;
    buf1 << 7;
    int n = 0;
    buf1 >> n;
    std::cout << "buf1 = " << buf1.str() << " n = " << n << '\n';
 
    // 输入流
    std::istringstream inbuf("-10");
    inbuf >> n;
    std::cout << "n = " << n << '\n';
 
    // 输出流在追加模式（C++11）
    std::ostringstream buf2("test", std::ios_base::ate);
    buf2 << '1';
    std::cout << buf2.str() << '\n';
}

输出：

buf1 = 7 n = 7
n = -10
test1

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
P0935R0	C++11	默认构造函数是显式的	改成隐式的

参阅

str	获取或设置底层字符串设备对象的内容 (公开成员函数)
(构造函数)	构造一个 basic_stringbuf 对象 (std::basic_stringbuf<CharT,Traits,Allocator> 的公开成员函数)