setbuf

void setbuf( FILE* stream, char* buffer );

void setbuf( FILE* restrict stream, char* restrict buffer );

#define BUFSIZ  /* unspecified */

ストリーム操作に使用する内部バッファを設定します。少なくとも BUFSIZ 文字の長さが必要です。

buffer が null でない場合、setvbuf(stream, buffer, _IOFBF, BUFSIZ) と同等です。

buffer が null の場合、setvbuf(stream, NULL, _IONBF, 0) と同等になり、バッファリングが無効になります。

引数

ノート

BUFSIZ が適切なバッファサイズでない場合、setvbuf を使用して変更できます。

setvbuf はエラーを検出するためにも使用すべきです。なぜなら、setbuf は成功または失敗を示さないからです。

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

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

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

例

#include <stdio.h>
#include <threads.h>

int main(void)
{
    setbuf(stdout, NULL); // unbuffered stdout
    putchar('a'); // 'a' appears immediately if stdout is unbuffered
    thrd_sleep(&(struct timespec){ .tv_sec = 1 }, NULL); // sleep 1 sec
    putchar('b');
}

ab

参考文献

関連項目