std::strstream::strstream

 

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::strstream

成员函数

strstream::strstream

strstream::~strstream

strstream::rdbuf

strstream::str

strstream::pcount

strstream::freeze

 

strstream();	(1)
strstream(char* s, int n, std::ios_base::openmode mode                            = std::ios_base::in | std::ios_base::out);	(2)

构造新的输入/输出 strstream 和它底层的 std::strstreambuf。

1) 默认构造底层 std::strstreambuf，这会创建动态成长的缓冲区，并以该 strstreambuf 成员的地址初始化基类。

2) 以底层 std::strstreambuf 成员的地址初始化基类，该成员通过以下两种方式之一初始化，两者都会使用用户提供的数组：

a) 如果 (mode & app) == 0（mode 中未设置 app 位），那么通过调用 strstreambuf(s, n, s) 构造缓冲区。如果首元素被 s 指向的数组中的元素少于 n 个，那么行为未定义。

b) 如果 (mode & app) != 0（mode 中设置了 app 位），那么通过调用 strstreambuf(s, n, s + std::strlen(s)) 构造缓冲区。如果首元素被 s 指向的数组的中元素少于 n 个，或数组不含合法的空终止字符序列，那么行为未定义。

参数

s	-	用作输出缓冲区的 char 数组
n	-	用作输出缓冲区的数组大小
mode	-	指定流打开模式。它是位掩码类型，定义下列常量（尽管只会使用 app）： 常量 解释 app 每次写入前寻位到流结尾 binary 以二进制模式打开 in 为读打开 out 为写打开 trunc 在打开时舍弃流的内容 ate 打开后立即寻位到流结尾 noreplace (C++23) 以独占模式打开

示例

运行此代码

#include <iostream>
#include <strstream>
#include <string>
 
int main()
{
    // 动态缓冲区
    std::strstream s1; // 动态缓冲区
    s1 << 1 << ' ' << 3.14 << " example" << std::ends;
    std::cout << "缓冲区持有：'" << s1.str() << "'\n";
    s1.freeze(false);
 
    int n;
    double d;
    std::string w;
    s1 >> n >> d >> w;
    std::cout << "读取：n = " << n
              << " d = " << d
              << " w = '" << w << "'\n";
 
    // 静态缓冲区
    char arr[20] = "-1 -3.14 ";
    std::strstream s2(arr, sizeof arr, std::ios_base::app);
    s2 << "another" << std::ends;
    std::cout << "缓冲区持有：'" << s2.str() << "'\n";
    s2 >> n >> d >> w;
    std::cout << "读取：n = " << n
              << " d = " << d
              << " w = '" << w << "'\n";
}

输出：

缓冲区持有：'1 3.14 example'
读取：n = 1 d = 3.14 w = 'example'
缓冲区持有：'-1 -3.14 another'
读取：n = -1 d = -3.14 w = 'another'

缺陷报告

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

缺陷报告	应用于	出版时的行为	正确行为
LWG 115	C++98	重载 (2) 只会考虑 mode & app == 0 这种情况（== 的优先级高于 &）	考虑 (mode & app) == 0 和 (mode & app) != 0 这两种情况

参阅

(构造函数)	构造 strstreambuf 对象 (std::strstreambuf 的公开成员函数)
(构造函数)	构造 istrstream 对象，部分情况下会分配缓冲区 (std::istrstream 的公开成员函数)
(构造函数)	构造 ostrstream 对象，部分情况下会分配缓冲区 (std::ostrstream 的公开成员函数)