setbuf
ステートメント ストリームのリング バッファー。この関数は使用されていません。; setvbuf を使用します。
void setbuf(
FILE *stream,
char *buffer
);
パラメーター
stream
FILE 構造体へのポインター。buffer
ユーザーが割り当てたバッファー。
解説
setbuf の関数は stream のリング バッファーを制御します。stream の引数は読まれなかったし書き込まれなかった開いているファイルを参照する必要があります。buffer の引数が NULL 場合はストリームはバッファー。そうでない場合バッファーは BUFSIZ が STDIO.H. で定義されているバッファー サイズである BUFSIZ 長さの文字配列を指している必要があります。指定したストリームに既定で割り当てられるバッファー システムの代わりにユーザーが指定した I/O バッファーはリング バッファーに使用されます。stderr ストリームは既定ではバッファーに stderrバッファーの割り当てに setbuf を使用できます。
setbuf は setvbuf で置き換えられました新しいコードの適切なルーチンがあります。setbuf既存のコードで互換性のために残されています。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
setbuf |
<stdio.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_setbuf.c
// compile with: /W3
// This program first opens files named DATA1 and
// DATA2. Then it uses setbuf to give DATA1 a user-assigned
// buffer and to change DATA2 so that it has no buffer.
#include <stdio.h>
int main( void )
{
char buf[BUFSIZ];
FILE *stream1, *stream2;
fopen_s( &stream1, "data1", "a" );
fopen_s( &stream2, "data2", "w" );
if( (stream1 != NULL) && (stream2 != NULL) )
{
// "stream1" uses user-assigned buffer:
setbuf( stream1, buf ); // C4996
// Note: setbuf is deprecated; consider using setvbuf instead
printf( "stream1 set to user-defined buffer at: %Fp\n", buf );
// "stream2" is unbuffered
setbuf( stream2, NULL ); // C4996
printf( "stream2 buffering disabled\n" );
_fcloseall();
}
}
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。