setbuf

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

ファイル入出力

型とオブジェクト
stdinstdoutstderr          FILE fpos_t
関数 ファイルアクセス fopenfopen_s (C11) freopenfreopen_s (C11)   fwide (C95) setbuf setvbuf fclose fflush 非書式化入出力 fgetc fgets fputc fputs getchar getsgets_s (C11まで)(C11) putchar puts ungetc fgetwcgetwc (C95)(C95) fgetws (C95) fputwcputwc (C95)(C95) fputws (C95) getwchar (C95) putwchar (C95) ungetwc (C95) 書式付き入力 scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11) wscanffwscanfswscanfwscanf_sfwscanf_sswscanf_s (C95)(C95)(C95)(C11)(C11)(C11) vscanfvfscanfvsscanfvscanf_svfscanf_svsscanf_s (C99)(C99)(C99)(C11)(C11)(C11) vwscanfvfwscanfvswscanfvwscanf_svfwscanf_svswscanf_s (C99)(C99)(C99)(C11)(C11)(C11)	直接入出力 fread fwrite 書式付き出力 printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11) wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11)   vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (C99)(C11)(C11)(C11)(C11) vwprintfvfwprintfvswprintfvwprintf_svfwprintf_svswprintf_svsnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11) ファイルポジショニング ftell fgetpos fseek fsetpos rewind エラーハンドリング clearerr feof ferror perror ファイル操作 remove tmpfiletmpfile_s (C11) rename tmpnamtmpnam_s (C11)

 

ヘッダー <stdio.h> で定義
void setbuf( FILE          *stream, char          *buffer );		(C99まで)
void setbuf( FILE *restrict stream, char *restrict buffer );		(C99以降)
#define BUFSIZ     /*unspecified*/

ストリーム操作に使用する内部バッファを設定します。BUFSIZ 文字以上である必要があります。

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

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

パラメータ

stream	-	バッファを設定するファイルストリーム
buffer	-	ストリームが使用するバッファへのポインタ。NULL ポインタが指定された場合、バッファリングは無効になります。

戻り値

なし。

注釈

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

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

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

一般的なエラーとして、stdin または stdout のバッファを、プログラム終了前にライフタイムが終了する配列に設定することがあります。

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

例

setbuf は、即時出力が必要なストリームのバッファリングを無効にするために使用できます。

このコードを実行

#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

参考文献

• C17標準 (ISO/IEC 9899:2018)

• 7.21.5.5 The setbuf function (p: 225)

• C11標準 (ISO/IEC 9899:2011)

• 7.21.5.5 The setbuf function (p: 307-308)

• C99標準 (ISO/IEC 9899:1999)

• 7.19.5.5 The setbuf function (p: 273)

• C89/C90標準 (ISO/IEC 9899:1990)

• 4.9.5.5 The setbuf function

関連項目

setvbuf	ファイルストリームのバッファとそのサイズを設定する (関数)
C++ ドキュメント setbuf