C言語関数辞典

≫ ホーム ≫ C言語ヘッダファイル別一覧 | C言語アルファベット別一覧 ≫ stdio.h ≫ freopen

freopen

ストリーム (stream) をクローズしてから新しいストリームをオープンします．

#include <stdio.h>

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

freopen 関数は stream が指す既存のストリームをクローズしてから filename が指す文字列を名前とするファイルを mode が指すモードでオープンし，そのファイルにストリームを結び付けます．このとき，そのストリームのエラー表示子 (error indicator) とファイル終了表示子 (end-of-file indicator) はクリアされます．

なお，freopen はストリームのクローズの失敗は無視します．

引数

filename: ファイル名 or 空ポインタ (NULL)
(空ポインタを指定した場合は，そのストリームに現在結び付けられているファイル名を指定したものとして，そのストリームのモードを mode で指定されたものへ変更します．※)
mode: モード (詳しくは fopen 関数のモードを参照してください)
stream: クローズするストリーム

戻り値

成功した場合: オープンしたストリームを制御するオブジェクトへのポインタ
失敗した場合: 空ポインタ

※ どのような状況でどのようなモード変更が可能かは処理系定義なので注意が必要です．

C言語サンプルプログラム

freopen 関数を使用したサンプルプログラムを以下に示します．以下のサンプルプログラムでは fopen を用いてファイルをオープンした後，fputs で文字列をファイルに書き込んでいます．そして freopen を用いてファイルを開き直した後，fgets を用いて書き込んだ文字列を再取得しています．

/* header files */
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

/* macros */
#define N 256

/* main */
int main(void) {
    FILE *fp;
    char *filename = "sample.txt";
    char *writeline = "I love Snoopy!";
    char readline[N] = {'\0'};

    /* ファイルを書き込みモードでオープン */
    if ((fp = fopen(filename, "w")) == NULL) {
        fprintf(stderr, "%sのオープンに失敗しました.\n", filename);
        exit(EXIT_FAILURE);
    }

    /* 文字列をsample.txtに書き込む */
    fputs(writeline, fp);

    /* ファイルをクローズし, 読み込みモードで再オープン */
    if ((fp = freopen(filename, "r", fp)) == NULL) {
        fprintf(stderr, "%sの再オープンに失敗しました.\n 詳細:%s",
                filename, strerror(errno));
        exit(EXIT_FAILURE);
    }

    /* ファイルの終端まで文字を読み取り表示する */
    fgets(readline, N, fp);
    puts(readline);

    /* ファイルのクローズ */
    fclose(fp);

    return EXIT_SUCCESS;
}

実行例

サンプルプログラムの実行結果は以下のようになります．

I love Snoopy!

cプログラマの必読書

たくさんあるc言語関連の書籍の中でも特に役に立った本です．よかったら参考にしてみてください．

c実践プログラミング第3版

c言語の実践的参考書．少々値段は張りますが初心者を脱しようとしている人は絶対に読むべきです．
文法だけでなく，コーディングスタイルやデバッグなど文字通り「実践的」なことが書かれているので非常にためになります．オライリーの本は，読みにくい本が多いのですが本書はとても読みやすくオススメです．

c言語ポインタ完全制覇 (標準プログラマーズライブラリ)

ポインタの解説書としては最高の書籍です．
この1冊でポインタを完全に理解することができます．全くの初学者が読むには敷居が高いですが，入門書を読み終えた後に読むと非常に有益です．

スポンサー