setbuf
ストリームのバッファリングを制御します。 この関数は使用されなくなりました; setvbuf を代わりに使用します。
void setbuf(
FILE *stream,
char *buffer
);
パラメーター
stream
FILE 構造体へのポインター。buffer
ユーザーが割り当てたバッファー。
解説
setbuf 関数は streamのバッファリングを制御します。 stream の引数は読まれなかったし、または作成してファイルを開く必要があります。 buffer の引数が NULLの場合、ストリームは、バッファリングされます。 そうでない場合、バッファーは BUFSIZ がインクルード.で定義されているバッファー サイズである 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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。