【MQL5】FileOpen関数の使い方と自動売買実装コード

1. FileOpen関数の概要と実務での活用法

MQL5のFileOpen関数は、ターミナル外部のファイルを作成、または開くためのゲートウェイとなる関数です。自動売買（EA）開発において、この関数は単に「ログを保存する」以上の重要な役割を担います。

実務レベルのEA開発では、以下のようなシーンで頻繁に活用されます。
– トレードログの記録: 標準の操作ログとは別に、分析用の詳細な約定データや独自指標の推移をCSV出力する。
– 外部パラメータの読み込み: 最適化された設定値を外部ファイルから読み込み、EAの挙動を動的に変更する。
– 計算結果のキャッシュ: 重い計算（複雑な統計処理など）の結果を一時ファイルに保存し、バックテストや再起動時の処理時間を短縮する。

初心者が特につまずきやすいのは「ファイルの保存場所」と「アクセス権限」です。MQL5はセキュリティ上の理由から、操作できるフォルダが厳格に制限（サンドボックス構造）されており、これを知らずに任意のドライブに書き込もうとするとエラーになります。

2. 構文と戻り値

FileOpen関数の基本的な構文は以下の通りです。

int  FileOpen(
   string  file_name,     // ファイル名（相対パス）
   int     open_flags,    // オープンモード（フラグ）
   short   delimiter=';', // 区切り文字（CSVの場合）
   uint    codepage=CP_ACP // 文字コード
   );

パラメータ解説

1. file_name: 操作したいファイル名です。通常は MQL5\Files フォルダからの相対パスで記述します。
2. open_flags: ファイルをどのように開くかを指定します。主要なフラグは以下の通りです。
3. FILE_WRITE: 書き込みモード
4. FILE_READ: 読み取りモード
5. FILE_CSV: CSV形式として扱う
6. FILE_BIN: バイナリ形式として扱う
7. FILE_ANSI: ANSI文字列として扱う（日本語を扱う場合は重要）
8. FILE_COMMON: 複数のMT5で共有するフォルダ（Commonフォルダ）を使用する
9. delimiter: CSVファイルの場合の区切り文字。日本ではカンマ（,）が一般的ですが、デフォルトはセミコロン（;）なので注意が必要です。

戻り値

• 成功した場合：ファイルハンドル（正の整数）を返します。以降のファイル操作はこのハンドル番号を通じて行います。
• 失敗した場合：INVALID_HANDLE（-1）を返します。

3. 具体的な使い方・実践サンプルコード

以下のサンプルは、EAが約定した際にその価格と時刻をCSVファイルに追記保存する実用的なコードです。

// 約定データをCSVに保存する関数
void SaveTradeLog(string symbol, double price, string type)
{
   string fileName = "TradeLog.csv";

   // ファイルを書き込みモードで開く
   // FILE_READ | FILE_WRITE を組み合わせることで、既存ファイルがある場合は末尾に追記可能
   // FILE_ANSI はエクセル等で開きやすくするために指定
   int fileHandle = FileOpen(fileName, FILE_CSV | FILE_READ | FILE_WRITE | FILE_ANSI, ',');

   if(fileHandle != INVALID_HANDLE)
   {
      // ファイルの書き込み位置を最後に移動（追記のため）
      FileSeek(fileHandle, 0, SEEK_END);

      // データの書き込み
      FileWrite(fileHandle, 
                TimeToString(TimeCurrent(), TIME_DATE|TIME_SECONDS), 
                symbol, 
                type, 
                DoubleToString(price, _Digits));

      // 必ずファイルを閉じる（閉じないとデータが保存されない・他からアクセスできない）
      FileClose(fileHandle);

      Print("ログを保存しました: ", fileName);
   }
   else
   {
      Print("ファイルオープンに失敗しました。エラーコード: ", GetLastError());
   }
}

// EAの注文処理後に呼び出すイメージ
void OnTradeTransaction(const MqlTradeTransaction& trans,
                        const MqlTradeRequest& request,
                        const MqlTradeResult& result)
{
   if(trans.type == TRADE_TRANSACTION_DEAL_ADD)
   {
      SaveTradeLog(trans.symbol, trans.price, "DEAL_ADD");
   }
}

4. 使用上の注意点とよくあるエラー

1. 「ファイルが開けない」エラー (Error 5004)

最も多いエラーです。FileOpenで指定するパスは、デフォルトで MQL5\Files フォルダ以下に限定されています。C:\Users\... のようなフルパスを指定しても、セキュリティ機能によってブロックされます。他のMT5と共有したい場合は FILE_COMMON フラグを使いましょう。

2. FileCloseの忘れ

FileOpenした後は、必ず FileClose でハンドルを解放しなければなりません。閉じ忘れると、EAを停止するまでファイルがロックされ、他のプログラム（Excelなど）で開けなくなったり、データが物理的に書き込まれなかったりする原因になります。

3. CSVの区切り文字

デフォルトのデリミタが ; であるため、Excelで直接開くと列が分かれないことがあります。日本で一般的なCSVを作成する場合は、第3引数に ',' を明示的に指定することを推奨します。

4. 文字化け

日本語（全角文字）を扱う場合、FILE_ANSI フラグを指定しないと、他のテキストエディタで開いた際に文字化けが発生しやすくなります。

5. 【重要】自動売買における約定スピードと環境の罠

アルゴリズムトレードにおいて、FileOpenなどのファイル操作を高速化することは重要ですが、それ以上に収益へ直結するのが「物理的なネットワーク遅延（レイテンシ）」です。どれほど優れたロジックを組み、効率的なコードを書いたとしても、ご自宅のPCから一般的なインターネット回線を通じて注文を出している限り、プロの世界では致命的な不利を背負っています。

FXのサーバーは通常、世界中のデータセンター（ロンドンやニューヨークなど）に設置されています。自宅PCからの注文は、地球の裏側まで何十ものネットワーク機器を経由するため、数百ミリ秒の遅延が発生します。このわずかな間に価格は変動し、予期せぬスリッページによって本来得られるはずの利益が削られていくのです。機関投資家と同じ土俵で戦い、約定スピードを極限まで高めるには、ブローカーのサーバーに物理的に近い場所にある「専用のVPS（仮想専用サーバー）」の導入が不可欠です。安定した24時間稼働と低レイテンシ環境を整えることこそが、システムトレーダーにとっての「勝つための最低条件」と言っても過言ではありません。