MQL4 文字列関数リファレンス｜StringFind・StringSubstr・DoubleToStr・StringFormat

int StringLen(string str);
// 戻り値: 文字列の文字数

int StringFind(
   string str,          // 検索対象の文字列
   string match_substr, // 検索する部分文字列
   int    start_pos = 0 // 検索開始位置
);
// 戻り値: 見つかった位置（0始まり）、見つからない場合は-1

string StringSubstr(
   string str,        // 元の文字列
   int    start_pos,  // 開始位置
   int    length = -1 // 長さ（-1=末尾まで）
);
// 戻り値: 切り出した部分文字列

void StringBasics()
  {
   string str ="USDJPY_H1_EA";

   // 長さ
   Print("長さ:", StringLen(str));  // 12

   // 検索
   int pos = StringFind(str,"H1");
   Print("H1の位置:", pos);  // 7

   // 部分文字列
   string pair = StringSubstr(str, 0, 6);  //"USDJPY"
   string tf   = StringSubstr(str, 7, 2);  //"H1"
   Print("通貨ペア:", pair," 時間軸:", tf);

   // 検索して通貨ペアを判定
   if(StringFind(Symbol(),"JPY") >= 0)
      Print("JPYペアです");
  }

void ConcatenateExample()
  {
   // + 演算子（簡単だが大量の結合では遅い）
   string msg ="Balance:" + DoubleToStr(AccountBalance(), 2)
              +" Equity:" + DoubleToStr(AccountEquity(), 2);

   // StringConcatenate（高速、大量の引数に対応）
   string result;
   StringConcatenate(result,"Balance:", DoubleToStr(AccountBalance(), 2)," Equity:", DoubleToStr(AccountEquity(), 2)," Spread:", MarketInfo(Symbol(), MODE_SPREAD));

   Print(result);
  }

int StringReplace(
   string& str,          // 対象文字列（書き換わる）
   string  find,          // 検索文字列
   string  replacement    // 置換文字列
);
// 戻り値: 置換した回数

void ReplaceExample()
  {
   string text ="Buy at 110.500, SL at 110.000, TP at 111.000";

   int count = StringReplace(text,"at","=>");
   Print("置換回数:", count);  // 3
   Print(text);  //"Buy => 110.500, SL => 110.000, TP => 111.000"
  }

void ConversionExample()
  {
   // 数値 → 文字列
   string priceStr = DoubleToStr(110.523, 3);  //"110.523"
   string lotStr   = DoubleToStr(0.1, 2);      //"0.10"
   string ticketStr = IntegerToString(12345);   //"12345"

   // 文字列 → 数値
   double price = StrToDouble("110.523");  // 110.523
   int    value = StrToInteger("42");      // 42

   // 価格表示（桁数自動）
   Print("Price:", DoubleToStr(Ask, Digits));  //"110.523" or"110.52300"
  }

void FormatExample()
  {
   // printf形式のフォーマット
   string msg = StringFormat("Ticket: %d, Price: %.5f, Lots: %.2f",
                              12345, 110.52300, 0.10);
   Print(msg);  //"Ticket: 12345, Price: 110.52300, Lots: 0.10"

   // ログ出力に便利
   Print(StringFormat("[%s] %s %s %.2f lots at %.5f",
         TimeToStr(TimeCurrent(), TIME_MINUTES),
         Symbol(),"BUY", 0.1, Ask));

   // パディング
   string padded = StringFormat("%-10s %8.2f","Balance:", AccountBalance());
   Print(padded);  //"Balance:    123456.78"
  }

void TrimCaseExample()
  {
   string str ="  Hello World";

   // トリミング
   StringTrimLeft(str);   //"Hello World"
   StringTrimRight(str);  //"Hello World"
   Print("[", str,"]");

   // 大文字・小文字変換
   string upper = str;
   string lower = str;
   StringToUpper(upper);  //"HELLO WORLD"
   StringToLower(lower);  //"hello world"
   Print("Upper:", upper);
   Print("Lower:", lower);
  }

void LogTrade(string action, int ticket, double lots, double price)
  {
   string logMsg = StringFormat("[%s] %s: %s %s %.2f lots @ %s SL=%s TP=%s",
      TimeToStr(TimeCurrent(), TIME_DATE|TIME_SECONDS),
      action,
      Symbol(),
      (action =="BUY" || action =="BUY_LIMIT") ?"Long" :"Short",
      lots,
      DoubleToStr(price, Digits),
      DoubleToStr(OrderStopLoss(), Digits),
      DoubleToStr(OrderTakeProfit(), Digits)
   );
   Print(logMsg);
  }

// コメント表示用の情報整形
string FormatAccountInfo()
  {
   string info ="";
   info += StringFormat("Balance:  %s %sn",
           DoubleToStr(AccountBalance(), 2), AccountCurrency());
   info += StringFormat("Equity:   %s %sn",
           DoubleToStr(AccountEquity(), 2), AccountCurrency());
   info += StringFormat("Spread:   %d ptsn",
           (int)MarketInfo(Symbol(), MODE_SPREAD));
   info += StringFormat("Positions: %dn", OrdersTotal());
   return info;
  }