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

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

MQL5でのファイル操作において、特定のファイルが存在するか確認したり、特定のパターン（例：拡張子が.csvのものすべて）に一致するファイルリストを取得したりする際に起点となるのがFileFindFirst関数です。

実務レベルの開発では、以下のようなシーンで頻繁に利用されます。
* バックテストデータの読み込み: 過去の自作インジケーターの出力結果（CSV等）をEAで読み込む際、ファイルが存在するか事前にチェックする。
* ログファイルの整理: 古くなったログファイルを検索し、削除またはアーカイブする。
* マルチターミナル連携: 複数のMT5間でファイルを介して情報を共有する際、新しいデータファイルが書き込まれたかを検知する。

初心者が特につまずきやすいのは、この関数単体では「最初の1つ」しか見つけられないという点です。複数のファイルを取得するには、後述するFileFindNextと組み合わせる必要があります。また、MQL5には「サンドボックス規制」があり、操作できるディレクトリが厳格に制限されている点も理解しておく必要があります。

2. 構文と戻り値

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

long  FileFindFirst(
   string  file_filter,     // 検索するファイル名のパターン（ワイルドカード可）
   string& returned_filename, // 見つかったファイル名を受け取る変数
   int     common_flag=0    // 検索場所を指定するフラグ（FILE_COMMONなど）
   );

パラメーター解説

1. file_filter: 検索条件です。"*"（全ファイル）や "*.csv"（CSVファイルのみ）のようにワイルドカードを使用できます。
2. returned_filename: 参照渡しされる文字列変数です。ファイルが見つかった場合、その名前がこの変数に格納されます。
3. common_flag:
   • 0: 各ターミナル専用の「Files」フォルダ内を検索します。
   • FILE_COMMON: 全てのMT5で共有される共通フォルダ内を検索します。

戻り値

• 成功時: 検索ハンドル（long型）を返します。このハンドルは、次のファイルを探す際や、検索を終了する際に使用します。
• 失敗時: INVALID_HANDLE を返します。

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

以下のサンプルは、データフォルダ内の「Files」ディレクトリにあるすべてのCSVファイルを検索し、そのファイル名をエキスパートログに出力するスクリプトです。

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

   // 最初のファイルを検索
   long searchHandle = FileFindFirst(filter, fileName, 0);

   if(searchHandle != INVALID_HANDLE)
   {
      PrintFormat("検索開始: パターン '%s'", filter);

      // 最初のファイル名を表示
      PrintFormat("見つかったファイル: %s", fileName);

      // 2つ目以降のファイルをループで取得
      while(FileFindNext(searchHandle, fileName))
      {
         PrintFormat("見つかったファイル: %s", fileName);
      }

      // 検索ハンドルを必ず閉じる（メモリ漏洩防止）
      FileFindClose(searchHandle);
      Print("検索が正常に終了しました。");
   }
   else
   {
      // ファイルが一つも見つからない、またはエラーの場合
      Print("対象のファイルが見つからないか、エラーが発生しました。");
   }
}

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

1. ハンドルのクローズ忘れ: FileFindFirstで取得したハンドルは、必ずFileFindCloseで閉じてください。閉じ忘れるとメモリリソースを消費し続け、最悪の場合ターミナルの動作が不安定になります。
2. フォルダ指定の不可: file_filterに "C:\MyData\*.csv" のような絶対パスを指定することはできません。MQL5のファイル操作は、セキュリティ上の理由からMQL5\Filesフォルダ内に限定されています。
3. 大文字・小文字の区別: Windows OS上ではファイル名の大文字・小文字は区別されませんが、MQL5のコード内での一貫性を保つため、常に同じ形式で扱うのがクオンツとしての良質なマナーです。
4. ファイルが見つからない場合: INVALID_HANDLEが返された際、本当にファイルがないのか、あるいはパスの指定ミス（サブフォルダの指定方法など）なのかをGetLastError()で確認する癖をつけましょう。

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

プロレベルのアルゴリズムトレードにおいて、ファイル操作やロジックの最適化と同じくらい重要なのが「実行環境」です。どれほど優れたEAを開発しても、自宅のPCから一般的なインターネット回線を通じて注文を出している限り、プロのクオンツやHFT（高頻度取引）業者がひしめく市場では圧倒的に不利な立場に置かれます。

FXの約定スピードは、ミリ秒（1000分の1秒）単位のネットワーク遅延（レイテンシ）によって劇的に変化します。自宅のネットワーク環境では、プロバイダーの混雑や物理的な距離による遅延が避けられず、画面上の価格と実際の約定価格が乖離する「スリッページ」を誘発し、致命的な損失を生む原因となります。これを極限まで排除し、安定した利益を追求するには、ブローカーのサーバーと同じデータセンター内、あるいは至近距離に設置された専用のVPS（仮想専用サーバー）での運用が不可欠です。24時間365日の安定稼働と、物理的な距離を短縮することによる超低レイテンシ環境こそが、シストレ開発者が最初に投資すべき「勝つためのインフラ」であることを忘れてはいけません。