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

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

MQL5のFileReadString関数は、開いたファイルから文字列（テキスト）を読み取るための関数です。CSVファイルから設定値を読み込んだり、外部ツールで生成したシグナルデータを取り込んだりする際に頻繁に使用されます。

実務レベルの開発において、この関数は「EAの外部設定（Config）の共通化」に非常に役立ちます。例えば、複数のEAで共通のロット管理ルールやストップロス幅を一つのテキストファイルに書き出しておき、各EAが起動時にFileReadStringでその値を読み込むようにすれば、パラメーター変更のたびに全てのEAをコンパイルし直す手間が省けます。

初心者がつまずきやすいポイントは、「今、ファイルのどの位置を読み取っているか（ファイルポインタ）」の意識が漏れることです。この関数は一度呼び出すと、読み取った分だけ自動的に読み取り位置が次に進みます。そのため、ループ処理と組み合わせて「どこまで読み取ったか」を正確に制御する技術が求められます。

2. 構文と戻り値

FileReadStringの構文は非常にシンプルですが、読み取るファイルの開き方（CSVモードかバイナリモードか）によって挙動が変わる点に注意が必要です。

string  FileReadString(
   int  file_handle,     // ファイルハンドル
   int  length=-1        // 読み込む文字列の長さ
   );

• file_handle: FileOpen()関数によって返されたファイル識別番号（ハンドル）を指定します。
• length: 読み込む文字数を指定します。デフォルトの -1 の場合、ファイルの種類によって挙動が変わります。
• CSVファイルの場合: 次の区切り文字（カンマやタブ、改行）までを読み込みます。
• バイナリファイルの場合: 文字列の長さ分だけ読み込みます。
• 戻り値: 読み取られた文字列を返します。

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

以下の例は、MQL5/Filesフォルダ内に保存された trade_settings.csv というファイルから、1行ずつ設定値を読み込むEAのシンプルな実装例です。

//+------------------------------------------------------------------+
//| 外部ファイルから設定を読み込むサンプルコード                            |
//+------------------------------------------------------------------+
void ReadConfigFromFile()
{
   string filename = "trade_settings.csv";

   // ファイルを読み取り専用、CSVモード、カンマ区切りで開く
   int file_handle = FileOpen(filename, FILE_READ|FILE_CSV, ',');

   if(file_handle != INVALID_HANDLE)
   {
      Print("ファイルオープン成功: ", filename);

      // ファイルの終端に達するまでループ
      while(!FileIsEnding(file_handle))
      {
         // 1項目（1セル分）を読み取る
         string data = FileReadString(file_handle);

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

      // 読み終わったら必ずファイルを閉じる
      FileClose(file_handle);
   }
   else
   {
      Print("ファイルのオープンに失敗しました。エラーコード: ", GetLastError());
   }
}

// EA初期化時に実行
int OnInit()
{
   ReadConfigFromFile();
   return(INIT_SUCCEEDED);
}

このコードでは、FileIsEnding()関数を使用してファイルの最後まで動的に読み取りを続けています。CSV形式でファイルを開いているため、FileReadStringを呼び出すたびにカンマ区切りのデータが1つずつ取得されます。

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

1. ファイルの場所: MQL5のファイル操作関数は、セキュリティ上の理由から「サンドボックス」内でのみ動作します。具体的には MQL5/Files フォルダ以下のファイルしか操作できません。デスクトップにあるファイルを直接読み取ることはできないため注意してください。
2. 型変換の必要性: FileReadStringはあくまで「文字列」としてデータを読み込みます。ロット数や価格などの数値として扱いたい場合は、StringToDouble()やStringToInteger()を使って型変換を行う必要があります。
3. 無限ループの罠: FileIsEnding()の判定を誤ったり、読み取り位置が動かないような実装をすると、EAがフリーズする原因になります。必ずファイルが開けたことを確認してから処理に入るようにしましょう。
4. エンコーディング: ファイルがUTF-16（Unicode）かUTF-8かによって、FileOpen時に適切なフラグ（FILE_ANSI等）を指定しないと、文字化けや読み込みエラーが発生することがあります。

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

アルゴリズムトレードにおいて、ロジックと同じくらい重要なのが「実行環境」です。自宅のPCや一般的な光回線でEAを稼働させている場合、プロバイダー経由のネットワーク遅延（レイテンシ）は避けられません。FXのマーケットはミリ秒単位で価格が変動しており、ごく僅かな注文送信の遅れが、本来意図した価格から乖離した「スリッページ」を引き起こします。

この遅延は、年間を通すと複利計算で致命的な損失の差となって現れます。プロのクオンツや専業トレーダーにとって、取引サーバーの物理的距離が近い場所に位置する専用のVPS（仮想専用サーバー）を利用することは、もはやオプションではなく「必須のインフラ」です。約定スピードを極限まで高め、ネットワークの不安定さによる機会損失を排除することこそが、長期的に利益を積み上げるための最初のステップとなります。