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

概要

ファイルを開く。

ヘッダ

stdio.h

形式

FILE* fopen(const char* restrict filename, const char* restrict mode);

引数

filename

ファイル名。

mode

モード。

戻り値

成功した場合は、オープンしたファイルを制御するための FILEオブジェクトへのポインタを返す。失敗した場合は、ヌルポインタを返す。

詳細

引数filename に指定した名前を持ったファイルをオープンし、ストリームを結びつける。

ファイル名は、環境に応じたファイルパスの表現を受け付ける。たとえば、Windows では “documents\\test.txt” や “test.txt” といった表記により、カレントディレクトリにある documentsディレクトリ内の test.txt を開くことができる。また、受け付けられることが保証された最大長は、FILENAME_MAXマクロで与えられている。
引数mode には、以下の指定を与えられる。

処理系によっては、これらのモード名の後ろに何らかの文字列を続ける形で、独自のモードを提供していることがある。たとえば、Visual Studio では、“r, ccs=UNICODE” のような形で、Unicode (UTF-16LE) のデータを入出力できる。

モードごとに、以下の表のような動作の違いがある。

注意

同時に開くことができるファイルの最大数が、FOPEN_MAXマクロで与えられている。

使用例

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

int main(void)
{
    FILE* fp = fopen("hello.txt", "w");
    if (fp == NULL) {
        fputs("ファイルオープンに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }

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

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

実行結果（標準出力）

実行結果（hello.txt）

Hello, World

関連

ファイルを閉じるには fclose関数を用いる。

解説章

第３９章