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

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

FileReadArrayは、バイナリファイルから配列データを一括で読み込むためのMQL5関数です。MQL5での開発において、多くのデータ（過去の価格、計算済みのインジケーター値、最適化されたパラメータなど）を効率よく管理するために欠かせない存在です。

実務での活用シーン

実務では主に以下の用途で活用されます。
* 機械学習モデルの重み読み込み: Python等で学習させたパラメータをバイナリ形式で保存し、EA側で一括読み込みする。
* カスタム履歴データの解析: 標準のMT5履歴ではなく、独自に蓄積したティックデータなどを高速にロードする。
* 計算負荷の軽減: 複雑な計算結果を一度ファイルに保存し、次回起動時に再利用することで初期化時間を短縮する。

実務でつまずきやすいポイント

多くの開発者が最初につまずくのは、「バイナリ形式」と「テキスト形式」の混同です。FileReadArrayは、FILE_BINフラグを指定して開いたファイルに対してのみ有効です。CSVファイル（テキスト形式）をこの関数で読み込もうとしても、データ型が一致せず、意図しない数値（文字化けのような数値）が配列に格納されてしまいます。

2. 構文と戻り値

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

uint FileReadArray(
   int    file_handle,    // ファイルハンドル（FileOpenの戻り値）
   void&  array[],        // 読み込み先の配列（参照渡し）
   int    start=0,        // 配列のどのインデックスから書き込むか
   int    count=WHOLE_ARRAY // 読み込む要素数（デフォルトはすべて）
);

パラメーターの解説

1. file_handle: FileOpen関数で取得した整数値のIDです。
2. array[]: 読み取ったデータを格納する配列です。数値型（int, doubleなど）や単純な構造体の配列が指定可能です。
3. start: 配列の書き込み開始位置を指定します。
4. count: 読み込む要素の個数を指定します。デフォルトのWHOLE_ARRAYはファイル末尾まで、もしくは配列が埋まるまで読み込みます。

戻り値

• uint型: 実際に読み取られた要素の個数を返します。
• 読み込みに失敗した場合は 0 を返します。詳細なエラーは GetLastError() で確認します。

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

以下は、保存済みの価格データ（バイナリ形式）を配列に一括で読み込み、その内容を表示する実用的なコード例です。

//+------------------------------------------------------------------+
//|                                              SampleFileRead.mq5 |
//+------------------------------------------------------------------+
void OnStart()
{
    string fileName = "price_data.bin";
    double priceBuffer[]; // 読み込み先の動的配列

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

    if(fileHandle != INVALID_HANDLE)
    {
        // 2. ファイルサイズを確認し、配列をリサイズ（必要に応じて）
        // FileSizeはバイト数、doubleは8バイトなので要素数を計算
        long fileSize = FileSize(fileHandle);
        int elementsCount = (int)(fileSize / sizeof(double));
        ArrayResize(priceBuffer, elementsCount);

        // 3. FileReadArrayで一括読み込み
        uint readCount = FileReadArray(fileHandle, priceBuffer);

        if(readCount > 0)
        {
            Print(readCount, " 個のデータを読み込みました。");
            // 最初の3つのデータを確認表示
            for(int i=0; i<MathMin(3, (int)readCount); i++)
            {
                PrintFormat("Data[%d] = %f", i, priceBuffer[i]);
            }
        }
        else
        {
            Print("データの読み込みに失敗しました。エラーコード:", GetLastError());
        }

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

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

1. 配列の型の一致

保存時がdouble型であれば、読み込み先の配列も必ずdouble型である必要があります。型が異なると、メモリ上のビット列が誤って解釈され、全く異なる数値になります。

2. 動的配列の事前準備

FileReadArrayは自動的に配列のサイズを拡張してくれません。あらかじめArrayResizeで十分な容量を確保しておくか、ファイルサイズから要素数を逆算してリサイズする必要があります。

3. 文字列を含む構造体の制限

文字列（string型）を含む構造体配列の読み書きには注意が必要です。string型は可変長であるため、バイナリとして単純に読み書きできません。構造体を利用する場合は、uchar型の固定長配列にするなどの工夫が必要です。

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

クオンツエンジニアとして最も強調したいのは、アルゴリズムの完成度と同じくらい「実行環境」が勝敗を分けるという事実です。FileReadArrayを用いてどれほど高速なデータ処理を実装したとしても、その注文を出す環境が「自宅のPC」であれば、その努力は水の泡になる可能性が高いです。

一般的な家庭用回線は、ブローカーのサーバーとの間に数十から数百のノードを経由するため、物理的なネットワーク遅延（レイテンシ）が数ミリ〜数十ミリ秒単位で発生します。この遅延は、相場急変時のスリッページを増大させ、バックテストの結果とリアルの収益を乖離させる最大の要因となります。プロの現場では、ブローカーの取引サーバーと同じデータセンター内に設置された専用のVPS（仮想専用サーバー）を利用することが絶対条件です。低遅延環境を構築することで、コンマ数秒を争う約定競争で優位に立ち、ネットワークの瞬断による致命的な機会損失を防ぐことができます。本気でシストレでの収益化を目指すのであれば、VPSの導入はコストではなく、必要不可欠な設備投資であると理解してください。