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

概要

ストリームを開きなおす

ヘッダ

stdio.h

形式

FILE* freopen(const char* restrict filename, const char* restrict mode, FILE* restrict stream);

引数

filename

ファイル名。あるいはヌルポインタ

mode

モード。

stream

すでに開かれているストリーム。

戻り値

成功した場合は、引数stream が返される。失敗した場合は、ヌルポインタを返す。

詳細

引数filename がヌルポインタの場合は、現時点でストリームに結び付けられているファイルを、引数mode のモードで開きなおす。どのような状況であれば成功あるいは失敗するのかは、処理系定義である。
引数filename がヌルポインタでない場合は、まずストリームをクローズする。ここで発生したエラーは無視される。続いて、引数filename、mode の値を使って fopen関数を呼び出したときと同様の処理によって、ストリームを開きなおす。
この関数は、stdin、stdout、stderr をファイルに結びつける用途で使用できる。

注意

使用例

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    FILE* stream = freopen("test.txt", "w", stdout);
    if (stream == NULL) {
        fputs("freopen が失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }

    if (fputs("test message\n", stream) == EOF) {
        fputs("ファイルへの書き込みに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }

    if (fclose(stream) == EOF) {
        fputs("ファイルクローズに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }
}

実行結果（標準出力）：

実行結果（test.txt）：

test message

関連

解説章