std::basic_spanbuf<CharT,Traits>::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::basic_spanbuf

公開成員函式

basic_spanbuf::basic_spanbuf (C++23)

basic_spanbuf::operator= (C++23)

basic_spanbuf::swap (C++23)

basic_spanbuf::span (C++23)

受保護的成員函式

basic_spanbuf::setbuf (C++23)

basic_spanbuf::seekoff (C++23)

basic_spanbuf::seekpos (C++23)

非成員函式

swap(std::basic_spanbuf) (C++23)

 

protected: std::basic_streambuf<CharT, Traits>* setbuf( CharT *s, std::streamsize n ) override;		(C++23 起)

使 basic_spanbuf 在緩衝區 [s, s + n) 上執行 I/O。等價地呼叫 this->span(std::span<CharT>(s, n))，然後返回 this。

在開啟模式中設定的位 （影響獲取區域的指標）	設定後的返回值
	eback()	gptr()	egptr()
std::ios_base::in	s	s	s + n
在開啟模式中設定的位 （影響放置區域的指標）	設定後的返回值
	pbase()	pptr()	epptr()
std::ios_base::out && !std::ios_base::ate	s	s	s + n
std::ios_base::out && std::ios_base::ate	s	s + n	s + n

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

引數

s	-	使用者提供的緩衝區中第一個 CharT 的指標
n	-	使用者提供的緩衝區中 CharT 元素的數量

返回值

this

注意

已棄用的流緩衝區 std::strstreambuf 或 boost.IOStreams 裝置 boost::basic_array 也可以在使用者提供的 char 陣列上實現 I/O 緩衝。

參閱

pubsetbuf	呼叫 setbuf() (std::basic_streambuf<CharT,Traits> 的公共成員函式)
setbuf [虛擬函式]	嘗試用陣列替換受控字元序列 (std::basic_stringbuf<CharT,Traits,Allocator> 的虛保護成員函式)
setbuf [虛擬函式]	嘗試用陣列替換受控字元序列 (std::strstreambuf 的虛保護成員函式)