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

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

MQL5のFileTell関数は、現在開いているファイル内において、「ファイルポインタ（読み書きの現在位置）」が先頭から何バイト目にあるかを取得するための関数です。

イメージとしては、読書中の「しおり」のようなものです。ファイルを開いてデータを読み進めたり書き込んだりすると、このポインタは自動的に進んでいきます。FileTellを使うことで、「今、ファイルのどの地点まで処理が終わったか」を正確に把握できます。

実務での活用シーン

実務開発において、FileTellは以下のような場面で重宝します。

• 中断した処理の再開： 巨大なCSVファイルを読み込む際、一度にすべて処理すると動作が重くなるため、少しずつ読み進めて現在の位置（FileTellの結果）をグローバル変数などに保存し、次のティックでその続きから読み込む（FileSeekで移動する）といった実装が可能です。
• ログの追記確認： 独自のログファイルを作成している際、書き込み前後のポインタの差分を取ることで、実際に何バイトのデータが書き込まれたかを厳密にチェックできます。

初心者の方は「ファイルサイズ（FileSize）」と混同しがちですが、FileSizeはファイル全体の大きさを、FileTellは現在の作業場所を指すという違いを意識しましょう。

2. 構文と戻り値

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

ulong  FileTell(
   int  file_handle    // ファイルハンドル
   );

パラメーター

• file_handle: FileOpen関数によって返されたファイルハンドル（識別番号）を指定します。

戻り値

• 成功した場合、ファイルの先頭からのバイト数を ulong 型（符号なし長整数）で返します。
• 失敗した場合は INVALID_HANDLE を返します。

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

以下のサンプルコードは、CSVファイルにデータを書き込み、その際の位置をFileTellで取得してログに表示する簡単なスクリプトです。

//+------------------------------------------------------------------+
//|                                              Sample_FileTell.mq5 |
//|                                  Copyright 2024, Quant Engineer  |
//+------------------------------------------------------------------+
void OnStart()
{
   string fileName = "FileTell_Demo.csv";

   // ファイルを書き込みモード（共有読み込み許可）で開く
   int fileHandle = FileOpen(fileName, FILE_WRITE | FILE_CSV | FILE_ANSI);

   if(fileHandle != INVALID_HANDLE)
   {
      Print("--- ファイル書き込み開始 ---");

      // 初期状態のポインタ位置（通常は0）
      ulong pos = FileTell(fileHandle);
      PrintFormat("書き込み前のポインタ位置: %d バイト", pos);

      // 1行目のデータを書き込む
      FileWrite(fileHandle, "Time", "Symbol", "Price");

      // 書き込み後のポインタ位置を確認
      pos = FileTell(fileHandle);
      PrintFormat("1行目書き込み後のポインタ位置: %d バイト", pos);

      // 2行目のデータを書き込む
      FileWrite(fileHandle, TimeToString(TimeCurrent()), _Symbol, Close[0]);

      // さらに進んだポインタ位置を確認
      pos = FileTell(fileHandle);
      PrintFormat("2行目書き込み後のポインタ位置: %d バイト", pos);

      // ファイルを閉じる
      FileClose(fileHandle);
      Print("ファイルを閉じました。");
   }
   else
   {
      PrintFormat("ファイルオープンに失敗しました。エラーコード: %d", GetLastError());
   }
}

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

開発時に陥りやすいポイントがいくつかあります。

1. ハンドルの有効性： FileTellを呼び出す前に、必ずFileOpenが成功しているか（ハンドルが INVALID_HANDLE でないか）を確認してください。無効なハンドルを渡すと予期せぬ動作を招きます。
2. バイナリモードとテキストモードの違い： FILE_BIN（バイナリ）で開いた場合、FileTellが返す値は純粋なバイト数です。しかし、FILE_CSVやFILE_TXTなどのテキストモードでは、改行コード（CRLF）が2バイト分としてカウントされるなど、エディタ上の文字数と一致しないことがある点に注意が必要です。
3. 読み取り専用モードでの位置： FILE_READでファイルを開いた直後は、ポインタは必ず0（先頭）にあります。読み進めるごとにFileTellの値は増加しますが、ファイルの終端（EOF）に達したかどうかを判定するには FileIsEnding 関数を併用するのが一般的です。

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

アルゴリズムトレードの世界において、FileTellを駆使した効率的なログ管理やデータ処理を行うことは基本ですが、それ以上に収益を左右するのが「注文執行のスピード」です。多くの日本人開発者が陥る罠は、自宅のPCや一般的な光回線でEAを運用してしまうことです。

FX取引における約定速度は、トレーダーのPCから証券会社のサーバーまでの物理的な距離とネットワーク経路（レイテンシ）に依存します。自宅PCからの注文は、プロバイダの混雑や家庭内LANの遅延に晒され、画面上の価格と実際の約定価格が乖離する「スリッページ」を頻発させます。コンマ数秒の遅れが、本来利益になるはずのトレードを損失に変えてしまうのです。

極限まで約定スピードを高め、有利な価格で約定させるには、証券会社のサーバーに物理的に近いデータセンター内に設置された「専用のVPS（仮想専用サーバー）」での運用が不可欠です。24時間365日の安定稼働はもちろん、ネットワーク遅延を最小化することが、クオンツエンジニアとして勝利を掴むための最低条件と言っても過言ではありません。