std::basic_filebuf<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_filebuf

公開成員函式

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::native_handle (C++26)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

受保護的成員函式

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

非成員函式

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

 

protected: virtual std::basic_streambuf<CharT, Traits>* setbuf( char_type* s, std::streamsize n )

如果 s 是空指標且 n 為零，則該 filebuf 對輸出變為無緩衝，這意味著 pbase() 和 pptr() 都為空，並且任何輸出都會立即傳送到檔案。

否則，呼叫 setbuf() 會用使用者提供的字元陣列替換內部緩衝區（受控字元序列），該陣列的第一個元素由 s 指向，並允許此 std::basic_filebuf 物件使用該陣列中多達 n 個位元組進行緩衝。

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

引數

s	-	指向使用者提供的緩衝區中第一個 CharT 的指標，或為空
n	-	使用者提供的緩衝區中 CharT 元素的數量，或為零

返回值

此物件

注意

此函式的使用條件以及所提供緩衝區的用法是實現定義的。

• GCC 4.6 libstdc++

setbuf() 只能在 std::basic_filebuf 未與檔案關聯時（否則無效）呼叫。使用使用者提供的緩衝區時，每次從檔案讀取 n-1 個位元組。

• Clang++3.0 libc++

setbuf() 可以在開啟檔案後但在任何 I/O 操作之前呼叫（否則可能崩潰）。使用使用者提供的緩衝區時，從檔案讀取的位元組數是適合緩衝區中 4096 的最大倍數。

• Visual Studio 2010

setbuf() 可以在任何時候呼叫，即使在某些 I/O 發生後。如果緩衝區中存在任何當前內容，則會丟失。

標準沒有為此函式定義任何行為，除了在任何 I/O 發生之前呼叫 setbuf(0, 0) 必須設定無緩衝輸出。

示例

提供 10k 緩衝區用於讀取。在 Linux 上，可以使用 strace 工具觀察實際讀取的位元組數。

執行此程式碼

#include <fstream>
#include <iostream>
#include <string>
 
int main()
{
    int cnt = 0;
    std::ifstream file;
    char buf[10241];
 
    file.rdbuf()->pubsetbuf(buf, sizeof buf);
    file.open("/usr/share/dict/words");
 
    for (std::string line; getline(file, line);)
        ++cnt;
    std::cout << cnt << '\n';
}

可能的輸出

356010

缺陷報告

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

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 173	C++98	n 的型別被錯誤指定為 int	更正為 std::streamsize

參閱

pubsetbuf	呼叫 setbuf() (std::basic_streambuf<CharT,Traits> 的公共成員函式)
setvbuf	為檔案流設定緩衝區及其大小 (函式)