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

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

MQL5の FileIsEnding 関数は、ファイルポインタ（読み取り位置）がファイルの終端（EOF: End Of File）に達しているかどうかを判定するための関数です。

実務レベルの開発、特に外部のCSVファイルから「過去の経済指標データ」や「独自のシグナル指示書」を読み込んでEA（エキスパートアドバイザー）に反映させる際、この関数は必須となります。

よくあるつまずきポイント：
初心者の多くは、ファイル内のデータ行数をあらかじめ固定でプログラムに書き込んでしまいがちです。しかし、運用中にデータ量が増減する場合、固定値では「データの読み飛ばし」や「存在しないデータの参照によるエラー」が発生します。FileIsEnding を適切に使うことで、データの終端を動的に検知し、安全に全てのデータを処理することが可能になります。

2. 構文と戻り値

FileIsEnding 関数の構成は非常にシンプルです。

bool FileIsEnding(
   int  file_handle    // ファイルハンドル
);

• file_handle: FileOpen 関数によって返された有効なファイルハンドル（整数値）を指定します。
• 戻り値: ファイルポインタが終端に達している場合は true、まだ読み取れるデータが残っている場合は false を返します。

この関数は、通常 while ループの継続条件として利用されます。

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

以下の例は、CSVファイルから価格データを読み込み、エキスパートログに表示する実用的なスクリプトです。

void OnStart()
{
    string fileName = "SignalData.csv";
    // 読み込みモードかつCSV形式でファイルを開く
    int fileHandle = FileOpen(fileName, FILE_READ | FILE_CSV | FILE_ANSI, ',');

    if(fileHandle != INVALID_HANDLE)
    {
        Print("ファイルの読み込みを開始します。");

        // ファイルの終端に達するまでループを回す
        while(!FileIsEnding(fileHandle))
        {
            // 1行から文字列を読み取る
            string data = FileReadString(fileHandle);

            if(data != "")
            {
                Print("取得データ: ", data);
            }
        }

        // 処理が終わったら必ずファイルを閉じる
        FileClose(fileHandle);
        Print("ファイルの読み込みが正常に終了しました。");
    }
    else
    {
        PrintFormat("エラー: ファイル %s を開けませんでした。エラーコード: %d", fileName, GetLastError());
    }
}

このコードでは、while(!FileIsEnding(fileHandle)) と記述することで、「終端ではない間（＝データがある間）、ループを繰り返す」という定石の処理を行っています。

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

1. 無限ループの危険性
   while ループ内で FileReadString や FileReadNumber などの「読み取り関数」を呼び出さない場合、ファイルポインタが移動しないため、FileIsEnding が永遠に false を返し続け、MT5がフリーズする原因になります。必ずループ内でポインタを進める操作を行ってください。

2. ハンドルの有効性チェック
   FileOpen が失敗して INVALID_HANDLE が返されている状態で FileIsEnding を実行すると、正しく判定が行えません。必ず事前にハンドルのチェックを行ってください。

3. バイナリモードでの挙動
   CSV（テキスト）モードだけでなくバイナリモードでも使用可能ですが、バイナリの場合はデータ構造を正確に把握していないと、終端ギリギリでの読み取りで予期せぬエラーが発生することがあります。

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

MQL5でファイル操作や高度なロジックを組み込んでも、それを実行するインフラが貧弱であれば、その努力はすべて無駄になります。自宅のPCや一般的な光回線を利用した自動売買には、「ネットワーク遅延（レイテンシ）」という致命的なリスクが潜んでいるからです。FX市場はミリ秒単位の争いであり、PCの処理能力不足や回線の瞬断によって注文が滑る（スリッページ）、あるいは約定拒否されることは珍しくありません。

プロのクオンツやアルゴリズムトレーダーにとって、取引サーバーの至近距離に位置する「専用VPS（仮想専用サーバー）」の導入は、もはやオプションではなく「前提条件」です。 24時間365日、安定した電源と超高速・低遅延なネットワーク環境でEAを稼働させることは、約定スピードを極限まで高め、物理的な環境要因による損失を排除するための唯一の解決策といえます。本気でシストレの収益性を追求するのであれば、まずは遅延のない強固なインフラを手に入れることから始めてください。