SETBUF

Section: C Library Functions (3)
索引 jman

BSD mandoc

索引

名称

setbuf setbuffer setlinebuf setvbuf - ストリームバッファリング操作

索引

ライブラリ

Lb libc

索引

書式

In stdio.h Ft void Fn setbuf FILE *stream char *buf Ft void Fn setbuffer FILE *stream char *buf int size Ft int Fn setlinebuf FILE *stream Ft int Fn setvbuf FILE *stream char *buf int mode size_t size

索引

解説

利用できる 3 タイプのバッファリングは、バッファリングなし、ブロックバッファリング、および行バッファリングです。出力ストリームがバッファリングなしの場合、情報は書き込まれるとただちに書き込み先ファイルや端末に表示されます。出力ストリームがブロックバッファリングの場合、多数のキャラクタが蓄積されブロックとして書き込まれます。出力ストリームが行バッファリングの場合、改行が出力されるか、または端末デバイスにアタッチされた任意のストリーム (通常は stdin) から入力が読み込まれるまで、キャラクタが蓄えられます。関数 fflush(3) を使用して、早めにブロックの出力を強制することもできます ( fclose(3) を参照)。

通常、すべてのファイルはブロックバッファリングされます。ファイルに対して最初の入出力操作が発生したとき、 malloc(3) が呼び出されて最適なサイズのバッファが獲得されます。 ( stdout が通常行うように) ストリームが端末を参照する場合は行バッファリングです。標準エラーストリーム stderr は常にバッファリングなしです。

Fn setvbuf 関数は、ストリームのバッファリング動作を変更するのに使用できます。 Fa mode パラメータは次の 3 つのマクロのどれかでなくてはなりません。

_IONBF: バッファリングなし
_IOLBF: 行バッファリング
_IOFBF: 完全バッファリング

Fa size パラメータは、最適サイズのバッファをいつも通りに遅延割当てさせるために 0 に設定できます。このパラメータが 0 でない場合、バッファリングなしのファイルを除けば、 Fa buf 引数は少なくとも長さが Fa size バイトのバッファを指していなくてはなりません。このバッファが現在のバッファの代わりに使用されます ( Fa size 引数が 0 でないものの、 Fa buf が NULL の場合、指定サイズのバッファがただちに割り振られ、クローズ時に解放されます。これは ANSI C の拡張です。移植可能コードはサイズが 0 の NULL バッファを使用するはずです)。

Fn setvbuf 関数はいつでも使用できますが、ストリームが ``アクティブ''な場合に、 (たとえば、入力の切り捨てや出力のフラッシュ等の) 奇妙な副作用を持つことがあります。移植可能なアプリケーションは、なんらかの 入出力 が実行される前に、指定された任意のストリームに対してこの関数を一度だけ呼び出すべきです。

他の 3 つの呼び出しは、実際には、 Fn setvbuf 呼び出しの別名にすぎません。戻り値がないことを除いて、 Fn setbuf 関数は以下の呼び出しと厳密に同じです。