MQL4 共通関数・変換関数リファレンス｜Alert・Comment・Print・Sleep・型変換

void OutputExamples()
  {
   // Print — エキスパートタブに出力
   Print("メッセージ: ", Symbol(), " Price=", Ask);

   // 複数引数を連結して出力
   Print("Balance=", AccountBalance(),
         " Equity=", AccountEquity(),
         " Margin=", AccountMargin());

   // PrintFormat — printf形式（ビルド600+）
   PrintFormat("Ticket: %d, Price: %.5f, Lots: %.2f",
               12345, Ask, 0.1);

   PrintFormat("[%s] %s %s %.2f @ %.5f",
               TimeToStr(TimeCurrent(), TIME_MINUTES),
               Symbol(), "BUY", 0.1, Ask);
  }

void UpdateComment()
  {
   string text = "";
   text += "=== EA Status ===\n";
   text += "Time: " + TimeToStr(TimeCurrent(), TIME_DATE|TIME_SECONDS) + "\n";
   text += "Balance: " + DoubleToStr(AccountBalance(), 2) + "\n";
   text += "Equity: " + DoubleToStr(AccountEquity(), 2) + "\n";
   text += "Spread: " + IntegerToString((int)MarketInfo(Symbol(), MODE_SPREAD)) + " pts\n";
   text += "Positions: " + IntegerToString(OrdersTotal()) + "\n";

   Comment(text);  // チャートの左上に表示

   // クリアする場合
   // Comment("");
  }

void CheckAlertCondition()
  {
   static datetime lastAlert = 0;

   // 1時間に1回だけアラート
   if(TimeCurrent() - lastAlert < 3600)
      return;

   double dd = (AccountBalance() - AccountEquity()) / AccountBalance() * 100;

   if(dd > 10)  // ドローダウン10%超
     {
      Alert("警告: ドローダウン ", DoubleToStr(dd, 1), "% - ",
            Symbol(), " Balance=", AccountBalance());
      lastAlert = TimeCurrent();
     }
  }

// メール送信（ツール→オプション→Eメールで設定が必要）
void SendTradeEmail(string action, int ticket, double lots, double price)
  {
   string subject = StringFormat("[%s] %s %s", action, Symbol(), TimeToStr(TimeCurrent()));
   string body = StringFormat(
      "Action: %s\nSymbol: %s\nTicket: %d\nLots: %.2f\nPrice: %.5f\nBalance: %.2f",
      action, Symbol(), ticket, lots, price, AccountBalance()
   );

   if(!SendMail(subject, body))
      Print("メール送信失敗: ", GetLastError());
  }

// プッシュ通知（ツール→オプション→通知で設定が必要）
void SendPushNotification(string message)
  {
   if(!SendNotification(message))
      Print("プッシュ通知失敗: ", GetLastError());
  }

// サウンド再生
void PlayTradeSound(bool isEntry)
  {
   if(isEntry)
      PlaySound("alert.wav");
   else
      PlaySound("ok.wav");
  }

// Sleep — ミリ秒単位の待機
// ※ OnTick()内での使用は推奨されない（ティック処理がブロックされる）
void WaitAndRetry()
  {
   Sleep(1000);  // 1秒待機
   RefreshRates();
  }

// GetTickCount — ミリ秒精度のタイマー
void MeasureExecutionTime()
  {
   uint startTime = GetTickCount();

   // 計測したい処理
   for(int i = 0; i < 1000; i++)
      double ma = iMA(NULL, 0, 20, 0, MODE_SMA, PRICE_CLOSE, i);

   uint elapsed = GetTickCount() - startTime;
   Print("処理時間: ", elapsed, "ms");
  }

bool CheckEAReady()
  {
   if(IsStopped())
     {
      Print("EA停止が要求されました");
      return false;
     }

   if(!IsTradeAllowed())
     {
      Print("自動売買が許可されていません");
      return false;
     }

   if(!IsConnected())
     {
      Print("サーバー未接続");
      return false;
     }

   if(IsTradeContextBusy())
     {
      Print("取引コンテキストビジー");
      return false;
     }

   return true;
  }

// テスト環境の判定
void DetectEnvironment()
  {
   if(IsTesting())
     {
      if(IsOptimization())
         Print("最適化モード");
      else if(IsVisualMode())
         Print("ビジュアルバックテスト");
      else
         Print("通常バックテスト");
     }
   else
     {
      if(IsDemo())
         Print("デモ口座でライブ稼働");
      else
         Print("本番口座でライブ稼働");
     }
  }

enum NOTIFY_LEVEL
  {
   NOTIFY_LOG,      // Printのみ
   NOTIFY_ALERT,    // Alert + Print
   NOTIFY_PUSH,     // Push通知 + Print
   NOTIFY_ALL       // 全通知
  };

input NOTIFY_LEVEL NotifyLevel = NOTIFY_ALERT;

void Notify(string message, NOTIFY_LEVEL level = NOTIFY_LOG)
  {
   // 常にPrint
   Print("[", Symbol(), "] ", message);

   if(IsTesting()) return;  // テスト中は通知しない

   if(level >= NOTIFY_ALERT && NotifyLevel >= NOTIFY_ALERT)
      Alert(message);

   if(level >= NOTIFY_PUSH && NotifyLevel >= NOTIFY_PUSH)
      SendNotification(Symbol() + ": " + message);

   if(NotifyLevel >= NOTIFY_ALL)
     {
      string subject = "[EA] " + Symbol();
      SendMail(subject, message);
     }
  }

// 使用例
void OnTradeEvent(string action, int ticket)
  {
   string msg = StringFormat("%s ticket=%d lots=%.2f profit=%.2f",
                              action, ticket, OrderLots(), OrderProfit());
   Notify(msg, NOTIFY_ALERT);
  }