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

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

MQL5で開発を行っていると、「特定のフォルダ内にある大量のCSVファイルを一括で読み込みたい」あるいは「古いログファイルだけを特定して削除したい」という場面に遭遇します。こうしたファイル操作の自動化・ループ処理において中心的な役割を果たすのが FileFindNext 関数です。

この関数は、FileFindFirst 関数で開始したファイル検索を継続し、次にマッチするファイル名を取得するためのものです。

実務での活用シーン：
* 外部データのインポート： Python等の外部ツールで生成した複数の予測スコアファイルを一括で読み込む。
* バックテストの集計： 大量に書き出したレポートファイルを走査し、統計を算出する。
* ディレクトリのクリーンアップ： 1ヶ月以上前の不要なログファイルを特定して削除する。

開発者がよくつまずくポイントは、この関数が単体では動作せず、必ず「検索ハンドル」を介して FileFindFirst や FileFindClose とセットで運用しなければならないという点です。これを理解していないと、無限ループに陥ったり、メモリリーク（リソースの開放漏れ）を引き起こしたりする原因となります。

2. 構文と戻り値

FileFindNext 関数の構文は以下の通りです。

bool  FileFindNext(
   long    search_handle,      // FileFindFirstから返された検索ハンドル
   string& returned_filename   // 見つかったファイル名を受け取る変数（参照渡し）
   );

パラメーター

1. search_handle: FileFindFirst 関数が成功した際に返される long 型の識別番号です。これによって「どの検索の続きか」をMT5が認識します。
2. returned_filename: 次に見つかったファイル名が格納される string 型の変数です。参照渡し（&）のため、関数実行後にこの変数の中身が書き換わります。

戻り値

• true: 次のファイルが見つかった場合。
• false: 次のファイルが見つからなかった場合（最後まで検索し終えた）、またはエラーが発生した場合。

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

以下に、MQL5\Files フォルダ内にあるすべての .csv ファイルを検索し、そのファイル名をエキスパートログに出力する実用的なコード例を示します。

void ListAllCsvFiles()
{
   string fileName;
   string filter = "*.csv"; // CSVファイルのみを対象にするフィルタ

   // 1. 検索の開始（最初のファイルを探す）
   // 第2引数は共通フラグ（0 または FILE_COMMON）
   long searchHandle = FileFindFirst(filter, fileName);

   // 検索ハンドルが無効（INVALID_HANDLE）でないか確認
   if(searchHandle != INVALID_HANDLE)
   {
      do
      {
         // 2. 見つかったファイル名に対する処理
         Print("見つかったCSVファイル: ", fileName);

         // ここで FileOpen などの処理を行うことが一般的です

      } 
      // 3. 次のファイルを検索する
      while(FileFindNext(searchHandle, fileName));

      // 4. 検索ハンドルを必ず閉じてリソースを解放する
      FileFindClose(searchHandle);
      Print("検索を正常に終了しました。");
   }
   else
   {
      // ファイルが一つも見つからない、またはパスが不正な場合
      Print("ファイルが見つからないか、エラーが発生しました。エラーコード: ", GetLastError());
   }
}

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

① ハンドルのクローズを忘れない

FileFindFirst で取得したハンドルは、OSのリソースを占有します。処理が終わったら必ず FileFindClose を呼び出してください。これを忘れると、MT5の動作が重くなったり、他のファイル操作ができなくなったりするバグの原因となります。

② MQL5のサンドボックス規制

MQL5ではセキュリティ上の理由から、操作できるディレクトリが厳格に制限されています。基本的には MQL5\Files フォルダ内（または共通フォルダ）のみです。それ以外の場所（デスクトップやCドライブ直下など）のファイルを検索しようとしても、関数は失敗します。

③ 検索開始時の「最初のファイル」の扱い

FileFindFirst を実行した時点で、すでに「1つ目のファイル」は見つかっています。そのため、サンプルコードのように do-while 文を使うのが最もスマートです。普通の while 文で先に FileFindNext を呼んでしまうと、1つ目のファイル名が上書きされて飛ばされてしまうミスが多発します。

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

アルゴリズムトレードにおいて、ファイル操作やロジックの最適化と同じくらい、あるいはそれ以上に重要なのが「物理的な実行環境」です。自宅のPCや一般的な光回線でEAを稼働させることは、プロのクオンツから見れば極めてリスクの高い行為と言わざるを得ません。

FXのマーケットは1ミリ秒（0.001秒）単位で価格が変動しています。自宅PCから海外にある取引サーバーへ注文を出す場合、ネットワークの経由地が多く、数百ミリ秒のレイテンシ（遅延）が発生します。この遅延が「スリッページ」を引き起こし、本来利益が出るはずの局面で注文が滑り、致命的な損失を積み上げる原因となります。また、家庭用PCの予期せぬアップデートや停電、回線瞬断は、ポジションの閉じ損ねという最悪の事態を招きます。プロ仕様の約定スピードと24時間の安定稼働を確保するには、取引サーバーに物理的に近いデータセンターに設置された専用のVPS（仮想専用サーバー）導入が不可欠です。インフラへの投資を惜しむことは、シストレにおける「隠れた最大のコスト」であることを忘れないでください。