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)) +" ptsn";
   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: %snSymbol: %snTicket: %dnLots: %.2fnPrice: %.5fnBalance: %.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);
  }