MQL4 ファイル操作リファレンス｜FileOpen・FileWrite・CSV・バイナリ・設定ファイル読み書き

int FileOpen(
   string file_name,    // ファイル名（Files/フォルダ内の相対パス）
   int    open_flags,   // オープンフラグの組み合わせ
   short  delimiter = '\t',  // CSVの区切り文字
   uint   codepage = CP_ACP   // コードページ
);
// 戻り値: ファイルハンドル（失敗時はINVALID_HANDLE）

void WriteTradeLog(int ticket, string action, double lots, double price)
  {
   string filename = "TradeLog_" + Symbol() + ".csv";

   int handle = FileOpen(filename, FILE_READ|FILE_WRITE|FILE_CSV, ',');

   if(handle == INVALID_HANDLE)
     {
      Print("ファイルオープン失敗: ", GetLastError());
      return;
     }

   // ファイル末尾に移動
   FileSeek(handle, 0, SEEK_END);

   // ファイルが空ならヘッダーを書く
   if(FileTell(handle) == 0)
      FileWrite(handle, "DateTime", "Action", "Symbol", "Ticket",
                "Lots", "Price", "Balance", "Equity");

   // データ行を書き込み
   FileWrite(handle,
      TimeToStr(TimeCurrent(), TIME_DATE|TIME_SECONDS),
      action,
      Symbol(),
      ticket,
      DoubleToStr(lots, 2),
      DoubleToStr(price, Digits),
      DoubleToStr(AccountBalance(), 2),
      DoubleToStr(AccountEquity(), 2)
   );

   FileClose(handle);
  }

void ReadTradeLog()
  {
   string filename = "TradeLog_" + Symbol() + ".csv";

   int handle = FileOpen(filename, FILE_READ|FILE_CSV, ',');

   if(handle == INVALID_HANDLE)
     {
      Print("ファイルが見つかりません");
      return;
     }

   // ヘッダー行をスキップ
   string header = FileReadString(handle);

   int lineCount = 0;
   while(!FileIsEnding(handle))
     {
      string dateTime = FileReadString(handle);
      string action   = FileReadString(handle);
      string symbol   = FileReadString(handle);
      int    ticket   = (int)FileReadNumber(handle);
      double lots     = FileReadNumber(handle);
      double price    = FileReadNumber(handle);
      double balance  = FileReadNumber(handle);
      double equity   = FileReadNumber(handle);

      if(StringLen(dateTime) > 0)
        {
         Print(dateTime, " ", action, " ", symbol,
               " ticket=", ticket, " lots=", lots);
         lineCount++;
        }
     }

   FileClose(handle);
   Print("読み込み完了: ", lineCount, "行");
  }

// テキストファイルへの書き込み
void WriteTextLog(string message)
  {
   string filename = "EA_Log.txt";
   int handle = FileOpen(filename, FILE_READ|FILE_WRITE|FILE_TXT|FILE_ANSI);

   if(handle == INVALID_HANDLE) return;

   FileSeek(handle, 0, SEEK_END);
   FileWriteString(handle,
      TimeToStr(TimeCurrent(), TIME_DATE|TIME_SECONDS) + " " + message + "\n");
   FileClose(handle);
  }

// テキストファイルの全文読み込み
string ReadTextFile(string filename)
  {
   int handle = FileOpen(filename, FILE_READ|FILE_TXT|FILE_ANSI);

   if(handle == INVALID_HANDLE)
      return "";

   int size = (int)FileSize(handle);
   string content = FileReadString(handle, size);

   FileClose(handle);
   return content;
  }

// 構造体をバイナリで保存
struct TradeRecord
  {
   int      ticket;
   int      type;
   double   lots;
   double   openPrice;
   datetime openTime;
  };

void SaveTradeRecords(TradeRecord &records[], int count)
  {
   int handle = FileOpen("trades.bin", FILE_WRITE|FILE_BIN);
   if(handle == INVALID_HANDLE) return;

   // レコード数を最初に保存
   FileWriteInteger(handle, count);

   for(int i = 0; i < count; i++)
     {
      FileWriteInteger(handle, records[i].ticket);
      FileWriteInteger(handle, records[i].type);
      FileWriteDouble(handle, records[i].lots);
      FileWriteDouble(handle, records[i].openPrice);
      FileWriteInteger(handle, (int)records[i].openTime);
     }

   FileClose(handle);
  }

int LoadTradeRecords(TradeRecord &records[])
  {
   int handle = FileOpen("trades.bin", FILE_READ|FILE_BIN);
   if(handle == INVALID_HANDLE) return 0;

   int count = FileReadInteger(handle);
   ArrayResize(records, count);

   for(int i = 0; i < count; i++)
     {
      records[i].ticket    = FileReadInteger(handle);
      records[i].type      = FileReadInteger(handle);
      records[i].lots      = FileReadDouble(handle);
      records[i].openPrice = FileReadDouble(handle);
      records[i].openTime  = (datetime)FileReadInteger(handle);
     }

   FileClose(handle);
   return count;
  }

void FileUtilityExample()
  {
   string filename = "test.txt";

   // 存在確認
   if(FileIsExist(filename))
      Print("ファイルが存在します");
   else
      Print("ファイルが存在しません");

   // ファイル削除
   if(FileIsExist("old_log.txt"))
      FileDelete("old_log.txt");

   // フォルダ作成（ビルド600+）
   FolderCreate("Logs");
   FolderCreate("Logs\\2024");

   // 共通フォルダへの書き込み（複数EAで共有）
   int handle = FileOpen("shared_data.txt",
                          FILE_WRITE|FILE_TXT|FILE_COMMON);
   if(handle != INVALID_HANDLE)
     {
      FileWriteString(handle, "共有データ");
      FileClose(handle);
     }
  }

// key=value形式の設定ファイル読み込み
string ReadSetting(string filename, string key, string defaultValue = "")
  {
   int handle = FileOpen(filename, FILE_READ|FILE_TXT|FILE_ANSI);
   if(handle == INVALID_HANDLE)
      return defaultValue;

   string result = defaultValue;

   while(!FileIsEnding(handle))
     {
      string line = FileReadString(handle);
      int eqPos = StringFind(line, "=");

      if(eqPos > 0)
        {
         string k = StringSubstr(line, 0, eqPos);
         string v = StringSubstr(line, eqPos + 1);
         StringTrimLeft(k); StringTrimRight(k);
         StringTrimLeft(v); StringTrimRight(v);

         if(k == key)
           {
            result = v;
            break;
           }
        }
     }

   FileClose(handle);
   return result;
  }

// 使用例
void LoadSettings()
  {
   double riskPercent = StrToDouble(ReadSetting("ea_config.ini", "RiskPercent", "2.0"));
   int    maxPositions = StrToInteger(ReadSetting("ea_config.ini", "MaxPositions", "3"));
   string allowedPairs = ReadSetting("ea_config.ini", "AllowedPairs", "USDJPY,GBPJPY");

   Print("Risk: ", riskPercent, "% MaxPos: ", maxPositions, " Pairs: ", allowedPairs);
  }