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 %s\n",
           DoubleToStr(AccountBalance(), 2), AccountCurrency());
   info += StringFormat("Equity:   %s %s\n",
           DoubleToStr(AccountEquity(), 2), AccountCurrency());
   info += StringFormat("Spread:   %d pts\n",
           (int)MarketInfo(Symbol(), MODE_SPREAD));
   info += StringFormat("Positions: %d\n", OrdersTotal());
   return info;
  }