setvbuf

指定されたファイルストリーム stream のバッファリングモードを、引数 mode で示された方法で変更します。さらに、

• buffer がヌルポインタの場合、内部バッファを size にリサイズします。
• buffer がヌルポインタでない場合、ストリームが buffer から始まるユーザー提供のサイズ size のバッファを使用するように指示します。ストリームは、 buffer が指す配列の ライフタイム が終了する前に（ fclose で）閉じる必要があります。 setvbuf の呼び出しが成功した後の配列の内容は不定であり、それを使用する試みは未定義動作です。

パラメータ

戻り値

​ 0 ​ 成功時は0、失敗時は0以外の値を返します。

注記

この関数は、 stream が開かれたファイルに関連付けられた後、かつ他の操作（失敗した setbuf / setvbuf の呼び出しを除く）が行われる前にのみ使用できます。

すべての size バイトが必ずしもバッファリングに使用されるわけではありません：実際のバッファサイズは通常、2の倍数、ページサイズの倍数などに切り下げられます。

多くの実装では、行バッファリングは端末入力ストリームに対してのみ利用可能です。

よくあるエラーは、stdinまたはstdoutのバッファを、プログラム終了前に寿命が切れる配列に設定することです：

int main(void) {
    char buf[BUFSIZ];
    setbuf(stdin, buf);
} // bufの寿命が終了、未定義動作

デフォルトのバッファサイズ BUFSIZ は、その実装におけるファイルI/Oで最も効率的なバッファサイズと想定されていますが、POSIXの fstat がより適切な推定値を提供することが多いです。

例

// Make some POSIX functions, such as `int fileno(FILE*)`, visible:
#define _POSIX_SOURCE
#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
int main(void)
{
    FILE* fp = fopen("/tmp/test.txt", "w+");
    if (fp == NULL)
    {
        perror("fopen");
        return EXIT_FAILURE;
    }
    struct stat stats;
    if (fstat(fileno(fp), &stats) == -1) // POSIX only
    {
        perror("fstat");
        return EXIT_FAILURE;
    }
    printf("BUFSIZ is %d, but optimal block size is %ld\n", BUFSIZ, stats.st_blksize);
    if (setvbuf(fp, NULL, _IOFBF, stats.st_blksize) != 0)
    {
        perror("setvbuf failed"); // POSIX version sets errno
        return EXIT_FAILURE;
    }
    int ch;
    while((ch=fgetc(fp)) != EOF); // read entire file: use truss/strace to
                                  // observe the read(2) syscalls used
    fclose(fp);
    return EXIT_SUCCESS;
}

BUFSIZ is 8192, but optimal block size is 65536

参考文献

関連項目