std::strstreambuf::setbuf

 

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

公开成员函数

strstreambuf::strstreambuf

strstreambuf::~strstreambuf

strstreambuf::freeze

strstreambuf::str

strstreambuf::pcount

受保护成员函数

strstreambuf::underflow

strstreambuf::pbackfail

strstreambuf::overflow

strstreambuf::setbuf

strstreambuf::seekoff

strstreambuf::seekpos

 

protected: virtual streambuf<char>* setbuf(char* s, std::streamsize n);

如果 s 是空指针且 n 为零，那么函数无效果。

否则，效果由实现定义：一些实现不做任何事，而一些实现解分配动态成员数组并使用用户提供的大小为 n，首元素为 s 所指向的数组。

此函数是受保护的虚函数，它只能通过 pubsetbuf() 或从 std::strstreambuf 派生的用户定义类调用。

参数

s	-	指向用户提供缓冲区中首字节的指针
n	-	用户提供缓冲区中的字节数

返回值

this

示例

检查是否在动态 strstream 上支持 setbuf() 的实现测试（输出以 Sun Studio 获得）：

运行此代码

#include <strstream>
#include <iostream>
 
int main()
{
    char a[100] = {};
    std::strstream str;
    str.rdbuf()->pubsetbuf(a, sizeof a);
    str << "Test string" << std::ends;
    std::cout << "用户提供的缓冲区持有 \"" << a << "\"\n";
}

可能的输出：

用户提供的缓冲区持有 "Test string"

缺陷报告

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

缺陷报告	应用于	出版时的行为	正确行为
LWG 66	C++98	setbuf() 的效果是“执行分别在每个从 strstreambuf 派生 的类中定义的操作”，但是没有从 strstreambuf 派生的类	效果由实现定义

参阅

pubsetbuf	调用 setbuf() (std::basic_streambuf<CharT,Traits> 的公开成员函数)
setbuf [虚]	（在允许时）以用户定义数组替换缓冲区 (std::basic_streambuf<CharT,Traits> 的虚受保护成员函数)
setbuf [虚]	试图以数组替换受控字符序列 (std::basic_stringbuf<CharT,Traits,Allocator> 的虚受保护成员函数)
setbuf [虚]	提供用户供应的缓冲区，或将此 filebuf 转变为无缓冲 (std::basic_filebuf<CharT,Traits> 的虚受保护成员函数)