std::setvbuf

 

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)

 

C 風格 I/O

型別和物件
FILE fpos_t	stdinstdoutstderr
函式
檔案訪問 fopen freopen fclose fflush fwide setbuf setvbuf 直接輸入/輸出 fread fwrite 非格式化輸入/輸出 fgetcgetc fgets fputcputc fputs getchar gets (直到 C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 格式化輸入 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	格式化輸出 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf 檔案定位 ftell fgetpos fseek fsetpos rewind 錯誤處理 clearerr feof ferror perror 檔案操作 remove rename tmpfile tmpnam

 

定義於標頭檔案 <cstdio>
int setvbuf( std::FILE* stream, char* buffer, int mode, std::size_t size );

根據引數 mode 的指示，改變給定檔案流 stream 的緩衝模式。此外，

• 如果 buffer 是空指標，則將內部緩衝區大小調整為 size。
• 如果 buffer 不是空指標，則指示流使用從 buffer 開始的、大小為 size 的使用者提供緩衝區。流必須在 buffer 所指向陣列的生存期結束前關閉（使用 std::fclose）。成功呼叫 std::setvbuf 後，陣列的內容是不確定的，任何嘗試使用它的行為都是未定義的。

引數

stream	-	要設定緩衝區的檔案流
buffer	-	指向流使用的緩衝區的指標，或為空指標以僅改變大小和模式
mode	-	使用的緩衝模式。它可以是以下值之一 _IOFBF 全緩衝 _IOLBF 行緩衝 _IONBF 無緩衝
size	-	緩衝區大小

返回值

成功時返回 ​0​，失敗時返回非零值。

注意

此函式只能在 stream 已與一個開啟的檔案關聯之後，但在任何其他操作之前（除了對 std::setbuf/std::setvbuf 的失敗呼叫）使用。

並非所有 size 位元組都必然用於緩衝：實際緩衝區大小通常向下舍入為 2 的倍數、頁面大小的倍數等。

在許多實現上，行緩衝僅適用於終端輸入流。

一個常見的錯誤是將 stdin 或 stdout 的緩衝區設定為一個在程式終止之前其生命週期結束的陣列

int main()
{
    char buf[BUFSIZ];
    std::setbuf(stdin, buf);
} // lifetime of buf ends, undefined behavior

預設緩衝區大小 BUFSIZ 預計是實現上檔案 I/O 最有效的緩衝區大小，但 POSIX fstat 通常提供更好的估計。

示例

改變緩衝區大小的一個用例是已知更好的大小時。

執行此程式碼

#include <cstdio>
#include <cstdlib>
#include <iostream>
#include <sys/stat.h>
 
int main()
{
    std::FILE* fp = std::fopen("/tmp/test.txt", "w+");
    if (!fp)
    {
        std::perror("fopen");
        return EXIT_FAILURE;
    }
 
    struct stat stats;
    if (fstat(fileno(fp), &stats) == -1) // POSIX only
    {
        std::perror("fstat");
        return EXIT_FAILURE;
    }
 
    std::cout << "BUFSIZ is " << BUFSIZ << ", but optimal block size is "
              << stats.st_blksize << '\n';
    if (std::setvbuf(fp, nullptr, _IOFBF, stats.st_blksize) != 0)
    {
        std::perror("setvbuf failed"); // POSIX version sets errno
        return EXIT_FAILURE;
    }
 
    // Read entire file: use truss/strace to observe the read(2) syscalls used
    for (int ch; (ch = std::fgetc(fp)) != EOF;)
    {}
 
    std::fclose(fp);
    return EXIT_SUCCESS;
}

可能的輸出

BUFSIZ is 8192, but optimal block size is 65536

另請參閱

setbuf	為檔案流設定緩衝區 (函式)
setbuf [虛擬函式]	提供使用者提供的緩衝區或將此檔案緩衝區設為無緩衝 (std::basic_filebuf<CharT,Traits> 的虛保護成員函式)
C 文件 用於 setvbuf