std::fopen

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

C形式I/O

型とオブジェクト
FILE fpos_t	stdinstdoutstderr
関数
ファイルアクセス fopen freopen fclose fflush fwide setbuf setvbuf 直接入出力 fread fwrite 非書式化入出力 fgetcgetc fgets fputcputc fputs getchar gets (C++14まで) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 書式付き入力 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	書式付き出力 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf ファイルポジショニング ftell fgetpos fseek fsetpos rewind エラーハンドリング clearerr feof ferror perror ファイル操作 remove rename tmpfile tmpnam

 

ヘッダ<cstdio>で定義
std::FILE* fopen( const char* filename, const char* mode );

指定された filename のファイルをオープンし、そのファイルに関連付けられたファイルストリームを返します。mode はファイルアクセスモードを決定するために使用されます。

パラメータ

filename	-	ファイルストリームを関連付けるファイル名
モード	-	ファイルアクセスモードを決定するヌル終端文字列

ファイルアクセスフラグ

ファイルアクセス モード文字列	意味	説明	ファイルが存在する場合のアクション 既に存在する場合	ファイルが存在する場合のアクション 存在しない場合
"r"	read	読み込み用にファイルを開く	最初から読み込む	NULL を返し、エラーを設定します。
"w"	write	書き込み用にファイルを作成する	内容を破棄する	新規作成する
"a"	append	ファイルに追記する	末尾に書き込む	新規作成する
"r+"	拡張読み込み	読み書き用にファイルを開く	最初から読み込む	NULL を返し、エラーを設定します。
"w+"	拡張書き込み	読み書き用にファイルを作成する	内容を破棄する	新規作成する
"a+"	拡張追記	読み書き用にファイルを開く	末尾に書き込む	新規作成する
ファイルアクセスモードフラグ "b" は、オプションでファイルをバイナリモードで開くために指定できます。このフラグはPOSIXシステムでは影響しませんが、Windowsなどでは、'\n' および '\x1A' の特別な処理を無効にします。 追記ファイルアクセスモードでは、ファイル位置指示子の現在の位置に関係なく、データはファイルの末尾に書き込まれます。
ファイルアクセスモードフラグ "x" は、オプションで "w" または "w+" 指定子に追加できます。このフラグは、ファイルがすでに存在する場合に上書きする代わりに、関数の失敗を強制します。(C++17)
モードが上記リストのいずれかの文字列でない場合、動作は未定義です。一部の実装では、追加のサポートされているモードが定義されています（例：Windows）。

戻り値

成功した場合、オープンされたファイルストリームを制御するオブジェクトへのポインタを返します。このとき、eofビットとエラービットはクリアされます。ストリームは、filename が対話型デバイスを参照しない限り、フルバッファリングされます。

エラーが発生した場合、ヌルポインタを返します。POSIX では、この場合に errno が設定されることが要求されています。

注記

filename の形式は実装定義であり、必ずしもファイルを参照するとは限りません（例：コンソールやファイルシステムAPIを通じてアクセス可能な別のデバイスである可能性があります）。それらをサポートするプラットフォームでは、filename に絶対パスまたは相対パスを含めることができます。

移植性の高いディレクトリおよびファイル命名については、C++ファイルシステムライブラリまたはboost.filesystemを参照してください。

例

このコードを実行

#include <cstdio>
#include <cstdlib>
 
int main()
{
    int is_ok = EXIT_FAILURE;
    FILE* fp = std::fopen("/tmp/test.txt", "w+");
    if (!fp)
    {
        std::perror("File opening failed");
        return is_ok;
    }
 
    int c; // Note: int, not char, required to handle EOF
    while ((c = std::fgetc(fp)) != EOF) // Standard C I/O file reading loop
        std::putchar(c);
 
    if (std::ferror(fp))
        std::puts("I/O error when reading");
    else if (std::feof(fp))
    {
        std::puts("End of file reached successfully");
        is_ok = EXIT_SUCCESS;
    }
 
    std::fclose(fp);
    return is_ok;
}

出力

End of file reached successfully

関連項目

fclose	ファイルを閉じる (関数)
fflush	出力ストリームを実際のファイルと同期させる (関数)
freopen	既存のストリームを別の名前で開く (関数)
C言語のドキュメント (fopen)