この記事を開いてくださったこと、心から感謝しています。プログラムを、きれいに終わらせる方法を知りたいと考えている人も、きっと多いはずです。
結論から言うと、EAが自分から終わりたいときはExpertRemove、外から終了を求められたかを確かめたいときはIsStoppedです。終わらせる側と、終わりに気づく側という、向きの違う関数です。
また、エラーコードや、どのプログラムの種類で使えるかなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、ExpertRemove、IsStopped、UninitializeReasonの役割・動き・理由コード・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ExpertRemoveとIsStoppedは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つはEAを終わらせる関数で、もう1つは終了の合図を確かめる関数です。
ExpertRemoveは、EAを止めてチャートから外す
ExpertRemoveは、エキスパートアドバイザーを止めて、チャートから外す関数です。戻り値はなく、引数もありません。
公式の説明では、すぐには止まりません。呼び出すと、EAの動作を止める旗が立ち、次のイベントは処理されず、OnDeinitが呼ばれてから、チャートから外れます。
- EAを止めて、チャートから外す
- 戻り値も引数も、ない
- すぐには止まらず、旗が立つ
IsStoppedは、強制終了の合図を確かめる
IsStoppedは、MQL5プログラムが強制的に終わらされようとしているかを調べる、bool型の関数です。引数はありません。
公式の説明では、システム変数の_StopFlagが0でなければ、trueを返します。プログラムに終了の命令が出ると、この変数に0以外の値が入ります。
- 強制終了の合図を、確かめる
- 戻り値は、bool型
- _StopFlagが0でなければ、true
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ExpertRemove | IsStopped |
|---|---|---|
| 役割 | EAを終わらせる | 終了の合図を調べる |
| 戻り値 | なし | bool |
| 引数 | なし | なし |
| 向き | 自分から終わる | 外からの合図に気づく |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ExpertRemoveは、どんな場面で使うのか?
ExpertRemoveは、EAが自分で終わるべきだと判断したときに使います。公式の説明から、動き方と注意点を確認します。
呼んだあとも、少しだけ処理が続く
公式の説明では、ExpertRemoveは、動作を止める旗を立てるだけで、すぐには止まりません。次のイベントは処理されず、OnDeinitが呼ばれます。
公式サンプルでは、呼び出しのあとにメッセージを表示する処理が置かれています。同じ関数の中で、呼び出し後のコードが動くかどうかは、ページには、記載なしでした。
- 旗が立つだけで、すぐには止まらない
- 次のイベントは、処理されない
- 呼び出し後のコードは、記載なし
公式サンプルは、ティックを数えて止める
公式サンプルは、入力値で決めた回数のティックを数え、コメントで残りを表示します。回数に届くと、ExpertRemoveを呼んで、メッセージを表示します。
OnDeinitでは、終了の理由コードを表示して、コメントを消しています。ティックの仕組みは、OnTickとOnTimerの記事で整理しています。
- 入力値の回数だけ、ティックを数える
- 届いたら、ExpertRemoveを呼ぶ
- OnDeinitで、理由コードを表示する
ストラテジーテスターでは、呼ぶ場所で結果が変わる
公式の説明では、OnInitの中で呼ぶと、そのパラメータでのテストが取り消されます。ページは、これを初期化のエラーと説明しています。
OnInitが成功したあとで呼ぶと、テストは正常に終わります。OnDeinitとOnTesterが呼ばれ、取引の統計や、最適化の基準値も、使える状態になります。
- OnInitの中なら、テストが取り消される
- 成功後なら、テストは正常に終わる
- 統計と基準値は、使える
IsStoppedは、どんな場面で使うのか?
IsStoppedは、長く続く繰り返し処理の中で、終わる合図が出ていないかを確かめたいときに使います。公式の説明から、動き方を確認します。
3秒以内に終わらないと、強制的に完了される
公式の説明では、プログラムは、終了の命令を受けたら、すぐに終わらなければなりません。そうしないと、ターミナルが、3秒後に外から強制的に完了させます。
そのため、長い繰り返しの中では、定期的にIsStoppedを確かめて、合図が出たら抜ける作り方が安心です。これは、公式の説明をもとにした、筆者の考えです。
- 命令を受けたら、すぐに終わる必要がある
- 終わらないと、3秒後に強制完了される
- 繰り返しの中で、定期的に確かめる
公式サンプルは、繰り返しの条件に使う
公式サンプルは、スクリプトの中で、IsStoppedがfalseの間だけ、繰り返します。毎回、ローカル時刻をコメントで表示し、Sleepで16ミリ秒休みます。
抜けたあとは、停止の旗が立ったことを、メッセージで表示して、コメントを消しています。待ち時間を作る関数の注意点は、MessageBoxとPlaySoundの記事も参考になります。
- falseの間だけ、繰り返す
- 毎回、時刻をコメントで表示する
- 抜けたあとに、メッセージを表示する
どの操作で旗が立つかは、記載がない
IsStoppedのページには、どの操作で_StopFlagに値が入るのかは、書かれていません。ExpertRemoveとの関係や、テスターでの動きも、記載なしでした。
プログラムの種類ごとの対応も、サンプルがスクリプトである以外は、記載なしです。自分のプログラムで、小さく試して確かめましょう。
- 旗が立つ操作は、記載なし
- ExpertRemoveとの関係も、記載なし
- 対応するプログラムの種類も、記載なし
UninitializeReasonでは、何が分かるのか?
終わるときに、理由を知りたい場合は、UninitializeReasonが役に立ちます。OnDeinitの引数としても、同じ理由コードが渡されます。
終了の理由を、数字で返す
UninitializeReasonは、終了の理由コードを、int型で返す関数です。値は、OnDeinitが呼ばれる前に、_UninitReasonという変数にセットされます。
- 理由コードを、int型で返す
- OnDeinitの前に、値がセットされる
- OnDeinitの引数にも、同じ値が渡る
理由コードには、10種類がある
公式の定数のページには、10種類の理由が載っています。ExpertRemoveで終わった場合は、0のREASON_PROGRAMになります。
| コード | 意味 |
|---|---|
| 0 | EAがExpertRemoveで終わった |
| 1 | チャートから削除された |
| 2 | 再コンパイルされた |
| 3 | 銘柄や時間足が変わった |
| 4 | チャートが閉じられた |
| 5 | 入力値が変更された |
| 6 | 別の口座が有効になった |
| 7 | テンプレートが適用された |
| 8 | OnInitが0以外を返した |
| 9 | ターミナルが閉じられた |
※公式の定数のページの内容を、筆者が整理しました。
OnInitで呼んだときの値は、記載がない
UninitializeReasonのページには、OnInitの中で呼んだときに何が返るかは、書かれていません。サンプルは、OnInitでも呼んでいますが、値の意味の説明は、記載なしです。
- OnInitでの値は、記載なし
- エラーコードも、記載なし
- 自分の環境で、確かめる
どう使い分ければよいのか?
2つは、向きが逆の関数です。自分から終わるのか、外からの合図に気づくのかで、使い分けます。
自分から終わりたいなら、ExpertRemoveを選ぶ
EAが、あらかじめ決めた条件で、自分から終わりたいときは、ExpertRemoveが向いています。テスターでは、呼ぶ場所で結果が変わる点に、注意しましょう。
FX口座・ツールの比較一覧もあわせて確認してみてください。
終了の合図に気づきたいなら、IsStoppedを選ぶ
長い繰り返しの中で、外からの終了の合図に気づきたいときは、IsStoppedが向いています。3秒以内に抜ける作りにしておくと、強制完了を避けやすくなります。
- 長い繰り返しを、使っている
- 合図が出たら、すぐに抜けたい
- 強制完了を、避けたい
終了の理由を知りたいなら、UninitializeReasonを使う
なぜ終わったのかを、後から確かめたいときは、OnDeinitの引数か、UninitializeReasonを使います。入力値の変更と、チャートの削除などを、区別できます。
- 理由コードで、終わった原因を区別できる
- OnDeinitの引数でも、受け取れる
- 対応は、公式のコード表で確かめる
実際に使うとき、どんな順番で進めればよいのか?
最後に、3つの関数を使うときの、確認の順番を整理します。小さな部品から、順に確かめるのが安心です。
まずは、理由コードをログに出す
最初に、OnDeinitで、理由コードをログへ出します。チャートを閉じたとき、入力値を変えたときなど、操作ごとに、コードが違うことを確かめます。
- OnDeinitで、理由コードを出す
- 操作ごとの違いを、見比べる
- コード表と、照らし合わせる
次に、ExpertRemoveの動きを試す
公式サンプルのように、ティックを数えて、ExpertRemoveを呼ぶ小さなEAで、動きを確かめます。呼び出し後のコードが動くかも、自分の環境で試します。
- ティックを数えて、止めてみる
- 呼び出し後の動きを、確かめる
- テスターでも、試してみる
最後に、繰り返しの中でIsStoppedを確かめる
繰り返し処理を使う場合は、条件にIsStoppedを入れて、合図が出たら抜けるようにします。抜けたあとの後始末も、忘れずに入れましょう。









もう1つのコツは、後始末の処理を、OnDeinitの1か所にまとめておくことです。どの理由で終わっても、同じ流れで片付けやすくなります。
- 後始末を、OnDeinitにまとめる
- 理由は、まずログに出して確かめる
- 記載なしの点は、小さく試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ExpertRemoveを呼ぶと、すぐに止まるのか?
いいえ、公式の説明では、旗が立つだけで、すぐには止まりません。次のイベントは処理されず、OnDeinitが呼ばれてから、チャートから外れます。
- 旗が立つだけで、すぐには止まらない
- OnDeinitのあとで、外れる
IsStoppedは、どの操作でtrueになるのか?
確認したページには、その説明が見当たりませんでした。公式には、終了の命令が出ると_StopFlagに値が入る、と書かれているだけで、操作の種類は、記載なしです。
- 操作の種類は、記載なし
- 自分の環境で、確かめる
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?」
自分から終わるならExpertRemove、終了の合図に気づくならIsStoppedです。理由はUninitializeReasonで確かめられ、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










