setbuf | Programming Place Plus　Ｃ言語編　標準ライブラリのリファレンス

概要

ストリームに、バッファを設定する。

ヘッダ

stdio.h

形式

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

引数

stream

対象のストリーム。

buf

バッファとして使用する配列のメモリアドレス。その配列は BUFSIZ以上の大きさを持たなければならない。
あるいはヌルポインタを指定する。この場合、バッファリングしない。

戻り値

なし

詳細

指定ストリームにバッファを設定する。

引数buf に配列を指すポインタを指定すると、その配列をバッファ領域として使用する。この配列は、BUFSIZ の置換結果以上の大きさを持っていなければならない。

引数buf にヌルポインタを指定した場合は、バッファリングを行わない。

この関数を呼ぶタイミングは、対象のストリームがオープンされてから、そのストリームに対する何らかの操作が実行されるまでの間でなければならない。

注意

引数buf に配列を指定した場合は、対象のストリームを使用している間、その配列が存在し続けなけばならない。

使用例

#include <stdio.h>

int main(void)
{
    char stdoutBuf[BUFSIZ];

    // バッファリングを行う
    setbuf( stdout, stdoutBuf );

    char buf[80];
    printf( "文字列を入力してください" ); // 改行なし
    fgets( buf, sizeof(buf), stdin );
    printf( "入力内容：%s\n", buf );


    // バッファリング無しに変更
    setbuf( stdout, NULL );

    printf( "文字列を入力してください" ); // 改行なし
    fgets( buf, sizeof(buf), stdin );
    printf( "入力内容：%s\n", buf );
}

実行結果：

Hello
文字列を入力してください入力内容：Hello

文字列を入力してくださいHello
入力内容：Hello

関連

setvbuf関数の方が、より詳細な指定が行える。

解説章

第４３章