EAを開発していると、
パラメータを少し変えるだけでもOnDeinit()が呼ばれ、
チャートを閉じたときと同じ後処理が走ってしまいます。
既刊globalvariableset-get-mt4.mdのように、
OnDeinit()で状態を保存する実装をしていると、
開発中の些細な操作のたびに保存処理や通知が発生して、
煩わしく感じたことがあるかもしれません。
この記事では、UninitializeReason関数とREASON_定数を使い、
「なぜOnDeinit()が呼ばれたか」を判定し、
本当に必要な場面だけ処理を実行する方法を解説します。
・OnDeinit()が『同じ理由』で呼ばれるとは限らない理由
・UninitializeReason()とREASON_定数10個の一覧
・『保存・通知すべき理由』と『無視すべき理由』の切り分け
・既刊SendNotificationと組み合わせた実際に動くコード
UninitializeReasonとは何か
まず、OnDeinit()が抱える意外な前提を整理します。
OnDeinitは「毎回同じ処理」をしてしまいやすい
多くのEA記事のOnDeinit()は、
オブジェクトの削除やGlobalVariableの保存を、
理由を問わず一律に実行しています。
UninitializeReasonで「なぜ止まったか」が分かる
・チャートを閉じた、EAを外した、再コンパイルした等、理由は複数ある
・UninitializeReason()はその理由をint型の定数で返す
・OnDeinit()の中で呼び出して初めて意味を持つ
理由が分かれば、
「本当にEAが停止した」場合だけ重要な処理を行い、
開発中の操作では何もしない、という制御ができます。
既刊globalvariableset-get-mt4.mdとの関係
既刊globalvariableset-get-mt4.mdは、
OnDeinit()での保存という「やり方」を扱いましたが、
「いつ保存すべきか」というタイミングの制御は未解説でした。
本記事はその欠けていた判断軸を補う続編です。
シグネチャとREASON_定数一覧
公式リファレンスで仕組みを確認します。
シグネチャ
公式リファレンス(UninitializeReason)によると、シグネチャは次の通りです。
int UninitializeReason();
引数は無く、OnDeinit()が呼ばれる直前に、
確定した理由コードをint型で返すだけの関数です。
REASON_定数の一覧
公式リファレンス(終了理由の定数)によると、10個の定数があります。
| 定数 | 値 | 発生する場面 |
|---|---|---|
| REASON_PROGRAM | 0 | ExpertRemove()を呼んで自ら終了 |
| REASON_REMOVE | 1 | チャートからEAを外した |
| REASON_RECOMPILE | 2 | 再コンパイルした |
| REASON_CHARTCHANGE | 3 | 通貨ペア・期間を変更した |
| REASON_CHARTCLOSE | 4 | チャートを閉じた |
| REASON_PARAMETERS | 5 | 入力パラメータを変更した |
| REASON_ACCOUNT | 6 | 別アカウントへ切り替えた |
| REASON_TEMPLATE | 7 | 新しいテンプレートを適用した |
| REASON_INITFAILED | 8 | OnInit()が0以外を返して失敗した |
| REASON_CLOSE | 9 | MT4本体を終了した |
保存・通知すべき理由とそうでない理由の切り分け
10個すべてを同じ重みで扱う必要はありません。
通知すべきケース(本当にEAが止まる)
REASON_REMOVE・CHARTCLOSE・CLOSEの3つは、
EAの監視が実際に止まる場面のため、
保有ポジションがあるなら通知する価値があります。
通知を避けるべきケース(開発中の操作)
・PARAMETERS/RECOMPILE/CHARTCHANGE/TEMPLATEは、
監視そのものは止まらない理由
・これらで毎回通知すると、重要な通知を見落としやすい
REASON_INITFAILEDの特殊な扱い
OnInit()自体が失敗した場合は、
設定ミスの可能性が高いため、
開発中の操作とは別枠で通知する価値があります。
実際に動くコード全体:理由に応じて通知するEA
既刊SendNotificationと組み合わせ、
本当に止まった場合だけスマホに通知します。
//+------------------------------------------------------------------+
//| NotifyOnRealStop.mq4 |
//| Copyright 2026, FX-EA System Project Creator |
//| https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property strict
//+------------------------------------------------------------------+
int OnInit()
{
return(INIT_SUCCEEDED);
}
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
if(ShouldNotify(reason))
{
string msg = StringFormat("%s EA停止 reason=%d", Symbol(), reason);
SendNotification(msg);
}
}
//+------------------------------------------------------------------+
bool ShouldNotify(const int reason)
{
switch(reason)
{
case REASON_REMOVE:
case REASON_CHARTCLOSE:
case REASON_CLOSE:
case REASON_INITFAILED:
return(true);
default:
return(false); //PARAMETERS/RECOMPILE/CHARTCHANGE/TEMPLATE/ACCOUNT/PROGRAMは無視
}
}
//+------------------------------------------------------------------+
入力パラメータ
このサンプルは判定ロジックの説明が目的のため、
入力パラメータは持たせていません。
OnDeinitの実装
OnDeinit(const int reason)の引数reasonには、
UninitializeReason()と同じ値が渡されるため、
このサンプルでは関数呼び出しを省略し、
引数reasonを直接switch文で判定しています。
MetaEditorでの実行手順
実際に動かして理由コードを確認する手順です。
- MetaEditorで新規EA「NotifyOnRealStop」を作成し、上のコードを貼り付ける
- F7キーでコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- チャートに適用後、パラメータ設定画面を開いて何も変えずOKを押し、通知が来ないことを確認する
- チャートを閉じて、通知が届くことを確認する
よくあるエラーと注意点
実装時につまずきやすい点をまとめます。
UninitializeReason()はOnDeinit内でのみ意味を持つ
OnInit()やOnTick()の中で呼び出しても、
その時点ではまだ終了理由が確定していないため、
意味のある値は返ってきません。
REASON_INITFAILEDはOnDeinitの引数にも渡る
OnInit()が失敗した場合でも、
MT4は必ずOnDeinit()を呼び出すため、
この分岐を用意しておかないと検知漏れになります。
MQL5でも同じ考え方が使える
MQL5にも同名のUninitializeReason()とREASON_定数があり、
考え方・定数名はMQL4とほぼ共通しています。
よくある質問
UninitializeReasonについて、よく検索される疑問に回答します。
GetLastError()と何が違いますか?
GetLastError()は直前の関数呼び出しのエラーを返すのに対し、
UninitializeReason()はEAやインジケーター自体の、
終了理由を返す別の目的の関数です。
インジケーターでも使えますか?
使えます。
EA・カスタムインジケーターのどちらでも、
OnDeinit()の中で同じように呼び出せます。
reason番号を直接比較してもいいですか?
動作はしますが、
将来の可読性のためREASON_PROGRAM等の定数名で、
比較することを公式リファレンスも推奨しています。
【MQL4】UninitializeReason関数でEAが『なぜ止まったか』を判定する方法について解説してみた(REASON_定数とOnDeinitの正しい使い分け):まとめ
OnDeinit()は、チャートを閉じたときだけでなく、
パラメータ変更や再コンパイルでも同じように呼ばれます。
UninitializeReason()とREASON_定数を使えば、
「本当に監視が止まる場面」だけを見分けて、
既刊SendNotificationのような重要な通知を、
開発中の操作で鳴らさずに済ませられます。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント