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

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

MQL5のFileReadStructは、バイナリファイルからデータを読み込み、それを直接「構造体（struct）」に格納するための関数です。

実務においては、単なる設定値の保存だけでなく、「EAの動作状態の復元」や「バックテスト用の独自ログ解析」などで非常に重宝します。例えば、EAが不慮の事態で停止した際、直前の注文状態や計算済みパラメーターを保持した構造体をバイナリとして保存しておけば、再起動時にFileReadStruct一つで瞬時に元の状態へ戻すことが可能です。

初心者が特につまずきやすいのは、「ファイルポインタ」の概念と「構造体の中身のデータ型」です。テキストファイルと違い、バイナリデータは1バイトでも型がズレると、構造体の中身が全く意味不明な値（ゴミデータ）になってしまいます。そのため、書き込み時（FileWriteStruct）と読み込み時で完全に同じ構造体定義を使用することが、実務上の絶対条件となります。

2. 構文と戻り値

FileReadStructの構文は以下の通りです。

uint  FileReadStruct(
   int          file_handle,    // ファイルハンドル
   void&        struct_object,  // 読み込み先の構造体変数
   int          size=-1         // 読み込むサイズ（省略時は構造体のサイズ）
   );

パラメーター解説

• file_handle: FileOpen関数で取得したファイル識別番号。必ず FILE_BIN モードで開いている必要があります。
• struct_object: 読み込んだデータを格納する構造体変数を「参照渡し」します。
• size: 読み込むバイト数です。通常はデフォルトの -1（構造体の全サイズを読み込む）で問題ありません。

戻り値

• 正常に読み込まれた場合は、読み込まれたバイト数が返されます。
• ファイルの終端（EOF）に達した場合やエラーが発生した場合は、構造体のサイズ未満の値（通常は0）が返されます。エラーの詳細は GetLastError() で確認します。

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

以下は、EAの取引設定（マジックナンバー、ロット数、メモ）をバイナリファイルから読み込む実用的なコード例です。

// 取引設定を保持する構造体の定義
struct MyTradeSettings {
   int      magic_number;  // マジックナンバー
   double   default_lot;   // デフォルトロット
   datetime last_trade;    // 最終取引時刻
   char     memo[32];      // メモ（固定長配列にするのがバイナリ操作のコツ）
};

void OnStart() {
   string file_name = "ea_settings.bin";
   MyTradeSettings settings;

   // 1. ファイルをバイナリ読み込みモードで開く
   int file_handle = FileOpen(file_name, FILE_READ|FILE_BIN);

   if(file_handle != INVALID_HANDLE) {
      // 2. FileReadStructで構造体にデータを一括読み込み
      uint bytes_read = FileReadStruct(file_handle, settings);

      if(bytes_read > 0) {
         // 読み込み成功時の処理
         Print("設定を読み込みました：");
         Print("- Magic: ", settings.magic_number);
         Print("- Lot: ", settings.default_lot);
         Print("- Memo: ", CharArrayToString(settings.memo));
      } else {
         Print("データの読み込みに失敗しました。エラーコード: ", GetLastError());
      }

      // 3. ファイルを閉じる
      FileClose(file_handle);
   } else {
      Print("ファイルが開けませんでした。ファイルが存在するか確認してください。");
   }
}

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

① 動的配列やstring型を含めない

構造体の中に動的配列（double data[]など）や、通常のstring型を含めた状態でFileReadStructを使うと、ポインタ情報だけが読み書きされ、実際の文字列データが正しく復元されません。文字列を扱う場合は、サンプルコードのように固定長のuchar配列（char memo[32]など）を使用するのが確実です。

② ファイルオープンモードの不一致

FileReadStructはバイナリ専用です。FileOpen時に FILE_CSV や FILE_TXT を指定すると、この関数は正しく動作しません。必ず FILE_BIN を指定してください。

③ アライメント（パディング）の問題

異なるビルド環境や外部DLLとデータをやり取りする場合、構造体のサイズがコンパイラによって調整（パディング）されることがあります。厳密なデータ管理が必要な場合は、構造体定義の前に #pack(push, 1) を使用して、境界調整を無効化することを検討してください。

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

アルゴリズムトレードにおいて、FileReadStructを使いこなしてロジックを最適化することは非常に重要ですが、それ以上に結果を左右するのが「取引環境の物理的な距離」です。どんなに優れたコードを書いても、自宅のPCから一般的なインターネット回線を通じて注文を出している限り、サーバーまでの物理的な距離に起因するネットワーク遅延（レイテンシ）からは逃れられません。

FXの自動売買では、ミリ秒単位の遅延が「スリッページ」を発生させ、本来得られるはずだった利益を削り取ります。特にボラティリティが高い局面では、自宅環境とブローカーのサーバーが設置されているデータセンターとの往復時間が致命的な損失に繋がることも珍しくありません。極限まで約定スピードを高め、優位性を確保するためには、ブローカーのサーバーに物理的に近い場所に位置する「自動売買専用のVPS（仮想専用サーバー）」の導入が必須と言えます。プロのクオンツエンジニアが自宅PCで本番運用を行わないのは、これが最大の理由です。