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

概要

ファイルを開く。

ヘッダ

stdio.h

形式

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

引数

filename

ファイル名。

mode

モード。

戻り値

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

詳細

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

ファイル名は、環境に応じたファイルパスの表現を受け付ける。たとえば、Windows では "documents\\test.txt" や "documents/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 );
    }

    return 0;
}

実行結果（標準出力）

実行結果（hello.txt）

Hello, World

関連

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

解説章

第３９章