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

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

FileCloseは、MQL5で開いたファイルハンドルを閉じ、リソースを解放するための関数です。FileOpen関数で取得した「ファイルの操作権限（ハンドル）」をシステムに返却する役割を担います。

実務開発において、初心者が最も陥りやすい罠は「ファイルを閉じ忘れること」です。MQL5（MetaTrader 5）の仕様上、同時に開けるファイル数には上限があり、閉じ忘れが蓄積すると新しいファイルを開けなくなるだけでなく、書き込んだはずのデータがディスクに保存されず、ファイルが破損する原因にもなります。

クオンツ開発の現場では、トレード履歴のログ出力、自作インジケーターのパラメータ保存、あるいは外部のPythonプログラムへ渡すためのデータエクスポートなどで頻繁に利用されます。「開けたら必ず閉じる」という処理は、堅牢なEA（エキスパートアドバイザー）を構築するための鉄則です。

2. 構文と戻り値

FileClose関数の仕様は非常にシンプルです。

void FileClose(
   int  file_handle      // FileOpenで取得したハンドル番号
);

• file_handle: FileOpen関数によって正常に取得された整数型のハンドル番号を指定します。
• 戻り値: なし（void）。関数を実行すると、即座にファイルが閉じられ、そのハンドルは無効化されます。

もし無効なハンドル（例：INVALID_HANDLE）を引数に渡したとしても、エラーは発生せず無視されますが、プログラムの可読性と安全性のために、ハンドルが有効であることを確認してから呼び出すのが一般的です。

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

以下のサンプルは、EAが起動した際の時刻をCSVファイルに記録し、安全にファイルを閉じる実戦的なスクリプトです。

//+------------------------------------------------------------------+
//|                                              FileCloseSample.mq5 |
//+------------------------------------------------------------------+
void OnStart()
{
   string fileName = "TradeLog.csv";

   // 1. ファイルを書き込みモード（共有読み取り許可）で開く
   // FILE_ANSI または FILE_UNICODE を指定するのが一般的
   int fileHandle = FileOpen(fileName, FILE_WRITE | FILE_CSV | FILE_ANSI, ',');

   if(fileHandle != INVALID_HANDLE)
   {
      // 2. データの書き込み
      string currentTime = TimeToString(TimeCurrent(), TIME_DATE | TIME_SECONDS);
      FileWrite(fileHandle, "LogEntry", currentTime, "EA Started");

      // 3. 【重要】処理が終わったら必ずFileCloseを呼び出す
      // これを忘れると、他のプログラムからファイルが読み取れない状態が続く
      FileClose(fileHandle);

      Print("ファイルの書き込みが完了し、正常にクローズされました。");
   }
   else
   {
      // ファイルが開けなかった場合のエラー処理
      PrintFormat("ファイル %s のオープンに失敗しました。エラーコード: %d", fileName, GetLastError());
   }
}

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

開発時に注意すべきポイントは以下の3点です。

1. バッファのフラッシュ（書き出し時刻）:
   FileWriteなどで書き込んだデータは、一旦メモリ上のバッファに蓄えられます。FileCloseを実行した瞬間に初めて物理的なディスクにすべて書き込まれるため、FileCloseを忘れると、PCの強制終了やMT5のクラッシュ時にデータが消失するリスクが高まります。
2. ループ内でのハンドルリーク:
   OnTickやOnTimerの中で毎回FileOpenを行い、条件分岐などでFileCloseをスキップしてしまうと、あっという間にファイルハンドルの上限に達し、EAが動作不全に陥ります。
3. 読み取り専用ファイルへの配慮:
   他のアプリケーション（Excelなど）で該当ファイルを開いている間は、FileOpenに失敗することがあります。この際、ハンドルがINVALID_HANDLEになるため、その状態でFileCloseを呼び出さないよう、ハンドルチェックを徹底しましょう。

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

アルゴリズムトレードにおいて、コードの最適化と同じ、あるいはそれ以上に重要なのが実行環境のネットワークレイテンシ（遅延）です。自宅のPCでEAを稼働させることは、プロのクオンツの視点からは極めてハイリスクな行為と言わざるを得ません。家庭用回線はプロバイダー経由の複雑な経路を通るため、注文が証券会社のサーバーに届くまでに数十〜数百ミリ秒の遅延が発生し、その間に価格が滑る（スリッページ）ことで、バックテスト通りの利益を得ることは物理的に不可能になります。

極限まで約定スピードを高め、意図した価格で注文を刺すためには、証券会社のサーバーと同じ、あるいは至近距離のデータセンターに設置された「専用のVPS（仮想専用サーバー）」の利用が必須です。VPSであれば、24時間365日の安定稼働はもちろん、ネットワークのホップ数を最小限に抑えることで、コンマ数秒を争うスキャルピングや急変時の決済において、致命的な損失を回避し、利益を最大化することが可能になります。トレード環境への投資を惜しむことは、勝率を自ら捨てることと同義です。