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

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

MQL5のFileReadDoubleは、バイナリ形式で保存されたファイルから「double型（倍精度浮動小数点数）」の数値を読み取るための関数です。

FXのシステムトレード開発において、価格データ、インジケーターの計算結果、あるいは独自アルゴリズムで算出した最適化パラメータなどをファイルに保存し、EA（エキスパートアドバイザー）で再利用するシーンは多々あります。

実務での活用ポイント：
多くの初心者は、数値をテキスト形式（CSVなど）で保存し、FileReadStringで読み取った後にStringToDoubleで変換しようとします。しかし、この方法では「型変換による処理負荷」と「データの肥大化」という2つの問題を抱えることになります。

FileReadDoubleを使用するバイナリ形式での運用は、データをメモリ上の表現のまま直接読み書きするため、読み込み速度が圧倒的に速く、ファイルサイズも最小限に抑えられるというメリットがあります。ミリ秒単位の判断が求められるクオンツ運用の世界では、こうしたデータ入出力の効率化は必須のテクニックです。

2. 構文と戻り値

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

構文

double  FileReadDouble(
   int  file_handle    // ファイルハンドル
   );

パラメーター

• file_handle: FileOpen関数によって返された有効なファイルハンドルを指定します。

戻り値

• 正常に読み取られた場合、現在のファイルポインタ位置から読み取った double 型の数値を返します。
• 読み取りに失敗した場合、またはファイルの終端（EOF）に達した場合は 0 を返します。エラーの詳細を確認するには GetLastError() 関数を使用します。

補足：
この関数を実行すると、ファイルポインタ（読み取り位置）は自動的に double 型のサイズ（8バイト）分だけ進みます。

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

以下のサンプルは、EAの初期化時に以前のトレード結果（利益目標など）をバイナリファイルから読み込む、実用的な実装例です。

//+------------------------------------------------------------------+
//| バイナリファイルから数値を読み込むサンプルコード                       |
//+------------------------------------------------------------------+
void ReadStoredTargetPrice()
{
   string fileName = "trade_data.bin";
   // ファイルをバイナリ読み取りモードで開く
   int fileHandle = FileOpen(fileName, FILE_BIN|FILE_READ);

   if(fileHandle != INVALID_HANDLE)
   {
      // ファイルサイズがdouble型のサイズ（8バイト）以上あるか確認
      if(FileSize(fileHandle) >= 8)
      {
         // バイナリデータから数値を直接読み込む
         double lastTargetPrice = FileReadDouble(fileHandle);

         Print("前回のターゲット価格をロードしました: ", lastTargetPrice);
      }
      else
      {
         Print("ファイルが空、またはデータが不足しています。");
      }

      // 開いたファイルは必ず閉じる
      FileClose(fileHandle);
   }
   else
   {
      Print("ファイルのオープンに失敗しました。エラーコード: ", GetLastError());
   }
}

//+------------------------------------------------------------------+
//| 書き込み側の例（参考）                                             |
//+------------------------------------------------------------------+
void SaveTargetPrice(double price)
{
   int fileHandle = FileOpen("trade_data.bin", FILE_BIN|FILE_WRITE);
   if(fileHandle != INVALID_HANDLE)
   {
      FileWriteDouble(fileHandle, price);
      FileClose(fileHandle);
      Print("価格を保存しました: ", price);
   }
}

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

1. FILE_BIN フラグの必須性

FileReadDoubleはバイナリファイルを対象とした関数です。FileOpen時に FILE_BIN フラグを指定せずに開いたファイル（テキストモードなど）に対してこの関数を使用すると、予期しない値が返される原因になります。

2. ファイルポインタの位置管理

複数の数値を連続して読み込む場合、現在のポインタがどこにあるかを意識する必要があります。特定のデータにアクセスしたい場合は、FileSeek関数を使用して読み取り開始位置を正確に制御してください。

3. データ型の不一致

FileWriteDoubleで書き込んだデータに対してのみ FileReadDouble を使うのが安全です。例えば、int型（4バイト）で書き込まれたデータを FileReadDouble（8バイト）で読もうとすると、隣接するデータまで巻き込んで読み取ってしまい、全く無意味な数値が表示されます。

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

アルゴリズムの効率化を突き詰め、FileReadDoubleで高速なデータ処理を実現したとしても、それを実行する「環境」が貧弱であれば、その努力は水の泡となります。日本の自宅PCから海外の取引サーバーへ注文を出す場合、物理的な距離に起因するネットワーク遅延（レイテンシ）は避けられません。このコンマ数秒の遅れが、スリッページを引き起こし、バックテストでは右肩上がりだったロジックを実運用で破綻させる最大の要因となります。

プロのクオンツエンジニアにとって、取引サーバーの至近距離に位置する専用のVPS（仮想専用サーバー）を利用することは、もはやオプションではなく「前提条件」です。安定した電源、24時間の稼働保証、そして何より極限まで抑えられたネットワーク遅延。これらのインフラが整って初めて、あなたの開発したアルゴリズムは真の性能を発揮します。わずかなVPSコストを惜しんで、不確実な自宅環境で致命的な損失を招くリスクを冒すべきではありません。