std::strstreambuf::setbuf

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

I/O 操縱器

列印函式 (C++23)

C 風格 I/O

緩衝區

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

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/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步輸出

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* setbuf( char* s, std::streamsize n );		(C++98 起棄用) (C++26 中移除)

如果 s 是空指標且 n 為零，此函式沒有效果。

否則，其效果由實現定義：某些實現不做任何事，而某些實現會解分配用作緩衝區的動態成員陣列，並開始使用大小為 n 的使用者提供的字元陣列，其第一個元素由 s 指向。

此函式為受保護的虛擬函式，只能透過 pubsetbuf() 或從使用者定義的派生自 std::strstreambuf 的類的成員函式呼叫。

引數

s	-	指向使用者提供緩衝區的第一個位元組的指標
n	-	使用者提供緩衝區中的位元組數

返回值

this

示例

用於檢查動態 strstream 上是否支援 setbuf() 的實現測試（輸出透過 Sun Studio 獲得）

執行此程式碼

#include <iostream>
#include <strstream>
 
int main()
{
    char a[100] = {};
    std::strstream str;
    str.rdbuf()->pubsetbuf(a, sizeof a);
    str << "Test string" << std::ends;
    std::cout << "user-provided buffer holds \"" << a << "\"\n";
}

可能的輸出

user-provided buffer holds "Test string"

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 66	C++98	setbuf() 的效果是“執行 為每個派生自 strstreambuf 的類單獨定義的操作”， 但沒有派生自 strstreambuf 的類	效果是 實現定義

參閱

pubsetbuf	呼叫 setbuf() (std::basic_streambuf<CharT,Traits> 的公共成員函式)
setbuf [virtual]	如果允許，用使用者定義的陣列替換緩衝區 (std::basic_streambuf<CharT,Traits> 的虛受保護成員函式)
setbuf [virtual]	嘗試用陣列替換受控字元序列 (std::basic_stringbuf<CharT,Traits,Allocator> 的虛受保護成員函式)
setbuf [virtual]	提供使用者提供的緩衝區或將此檔案緩衝區設為無緩衝 (std::basic_filebuf<CharT,Traits> 的虛受保護成員函式)