この記事を開いてくださったこと、心から感謝しています。MQL5の最適化で、エージェントから届く結果をどこで受け取ればよいか迷った人も多いはずです。
結論から言うと、届くたびに画面へ反映したいならOnTesterPass、取りこぼしを避けて最後にまとめて処理したいならOnTesterDeinitが向いています。
ただし、OnTesterDeinitがすべての結果を必ず受け取れるのかは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・結果の流れ・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
OnTesterPassとOnTesterDeinitは、そもそも何が違うのか?
まずは、公式リファレンスで説明されている、2つの関数の役割と、結果が届く流れを整理します。
OnTesterPassは、フレームが届くたびに呼ばれる
MQL5公式リファレンスによると、OnTesterPassは戻り値のない関数で、最適化の途中で新しいフレームが届いたときに呼ばれます。フレームとは、テストを行うエージェントから届く、1回分の結果のまとまりです。
このイベントは、フレームを受け取ったときに自動で発生します。使えるのはEAで、端末側に読み込まれたEAで動きます。
- 戻り値はない
- フレームが届くたびに呼ばれる
- 端末側のEAで動く
OnTesterDeinitは、最適化が終わったあとに呼ばれる
OnTesterDeinitも戻り値のない関数で、EAの最適化が終わったときに呼ばれます。公式リファレンスによると、最適化の結果を最後にまとめて処理するための関数です。
OnTesterPassやOnTesterDeinitのどちらかを持つEAは、テスターで設定した銘柄と期間の別のチャートに、自動で読み込まれます。
- 最適化が終わったあとに呼ばれる
- 結果の最終処理に使う
- 別のチャートに自動で読み込まれる
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | OnTesterPass | OnTesterDeinit |
|---|---|---|
| 呼ばれる時 | フレームが届いたとき | 最適化が終わったとき |
| 向いている使い方 | 途中経過の表示 | 最後のまとめ処理 |
| 戻り値 | なし | なし |
| 取りこぼし | 起こりうる | 対策に使える |
※公式の説明をもとにした、筆者の整理です。
OnTesterPassで受け取ると、どうなるのか?
次に、届くたびに受け取る1つ目の方法を見ていきます。
結果は、OnTesterからFrameAddで送られる
公式ページによると、1回のテストの結果は、エージェント側のOnTesterの中で、FrameAddを使って送ります。端末側では、FrameNextで、届いたフレームの番号・名前・ID・値を読み取ります。
成績を返すOnTesterの書き方は、OnTesterの比較記事で整理しています。
- エージェント側でFrameAddを使う
- 端末側でFrameNextを使う
- 番号・名前・ID・値を読める
FrameAddの名前とIDは、あとで絞り込むときの目印にもなります。結果の種類ごとに名前を変えて送ると、読み取る側で見分けやすくなります。ただし、数や大きさの上限は、確認したページに記載なしでした。
フレームは、まとまって遅れて届くことがある
公式ページには、FrameAddで送ったフレームは、まとまって届いたり、届くまでに時間がかかったりすることがある、と書かれています。そのため、すべてのフレームが、最適化の終わる前にOnTesterPassで処理されるとは限りません。
届く順番や回数は、確認できなかった
フレームが届く順番や、1回の呼び出しが1フレームに対応するのかは、確認したページに記載なしでした。また、OnTesterPassの中でFrameNextを使ってよいのかも、記載なしです。
- 届く順番は記載なし
- 1回が1フレームかは記載なし
- OnTesterPass内のFrameNextは記載なし
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
OnTesterDeinitで受け取ると、どうなるのか?
続いて、最後にまとめて受け取る2つ目の方法を見ていきます。
遅れて届いたフレームを、拾うために使える
公式ページによると、遅れて届いたフレームをすべて受け取りたいときは、読み取りのコードをOnTesterDeinitに書くとよい、という説明があります。この関数の中で、FrameNextを使って読み取ります。
そのあと、FrameFirstやFrameFilterを使えば、フレームを並べ直したり、絞り込んだりして、読み直すこともできます。
FrameNextは、読み取りに成功するとtrue、失敗するとfalseを返し、失敗の理由はGetLastErrorで調べます。読み取りの結果を毎回確かめる書き方にすると、途中で止まったときも、原因を追いやすくなります。
| したいこと | 使う関数 |
|---|---|
| フレームを読み取る | FrameNext |
| 先頭から読み直す | FrameFirst |
| 名前やIDで絞り込む | FrameFilter |
※公式の説明から読み取れる内容を、筆者が整理しました。
すべて受け取れるかは、確認できなかった
OnTesterDeinitが呼ばれる前に、すべてのフレームが届いているのかは、確認したページに記載なしでした。時間の制限についても、OnTesterDeinitのページには記載がありませんでした。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの使い方を比べます。
例の前提を、そろえる
最適化で、100通りの組み合わせを試して、1回ごとの結果を1つのフレームで送る場合を考えます。
- 100通りの組み合わせを試す
- 1回ごとに1つのフレームを送る
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
OnTesterPassなら、途中経過を見られる
OnTesterPassでは、フレームが届くたびに、画面の表示を更新できます。長い最適化でも、どこまで進んだのかが分かり、安心して待てます。ただし、遅れて届くフレームは、この時点では間に合わないことがあります。
たとえば、仮の100通りのうち、50通り分が届いた時点で、画面に半分まで進んだと表示できます。待っている間の不安が減るのは、うれしい点です。
- 届くたびに表示を更新できる
- 進み具合が分かる
- 遅れた分は間に合わないことがある
OnTesterDeinitなら、最後にまとめて並べられる
OnTesterDeinitでは、最適化が終わってから、残りのフレームも含めて、並べ直したり、ファイルに書き出したりできます。仮の100通りを、最後に1回で整理したいときに向いています。
途中で表示を更新しないぶん、処理が軽くなり、書くコードも少なくなります。ただし、終わるまで結果が見えないため、長い最適化では、様子が分からず不安になることもあります。
| 流れ(仮) | OnTesterPass | OnTesterDeinit |
|---|---|---|
| 途中 | 届くたびに更新 | 何もしない |
| 終了後 | 取りこぼしが残るかも | 残りを拾える |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
途中経過を見たいなら、OnTesterPassを選ぶ
進み具合を画面に出したいなら、OnTesterPassが向いています。動かす頻度の考え方は、OnTickとOnTimerの比較記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
取りこぼしを避けたいなら、OnTesterDeinitを選ぶ
結果を漏れなく整理したいなら、OnTesterDeinitが向いています。そのぶん、最適化が終わるまで、結果は見えません。両方を組み合わせて、途中は表示だけ、最後に整理する、という書き方も考えられます。
- 結果を漏れなく整理したい
- 最後にまとめて処理したい
- 表示と整理を分ける
小さく試して、動きを確かめる
いきなり大きな最適化を回さず、組み合わせの少ない小さな範囲で、届いた数をログに出してみましょう。OnTesterPassで数えた数と、最後に読み取れた数を見比べると、取りこぼしに気づけます。









ログに、届いたフレームの番号と数を並べて出しておくと、取りこぼしがないかを、あとから落ち着いて確かめられます。
小さな範囲で動きを確かめてから、組み合わせを少しずつ増やすと、思わぬ取りこぼしにも早く気づけます。結果を捨ててしまわないように、ファイルへ書き出す処理も、先に試しておくと安心です。
- 小さな範囲で試す
- 届いた数と読み取れた数を見比べる
- ファイルへの書き出しも先に試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
OnTesterInitは、どんなときに使うのか?
公式リファレンスによると、OnTesterInitは、最適化が始まる前に呼ばれます。0以外の値を返すと、最適化は始まりません。公式のサンプルでは、入力ごとに範囲を決めていました。
つまり、入力の範囲を決めたり、開始時刻を記録したりする準備は、OnTesterInitで行い、結果の整理は、OnTesterPassとOnTesterDeinitで行う、という分け方になります。
OnTickは、端末側のEAでも動くのか?
公式ページによると、端末側に読み込まれたEAは、TesterInit・TesterDeinit・TesterPassのイベントを受け取ります。一方、Init・Deinit・NewTickのイベントは受け取りません。そのため、OnTickは動きません。
- 3つのテスターイベントは受け取る
- OnTickは動かない
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のOnTesterPassとOnTesterDeinit、届くたびに結果を受け取る即時性と最適化の終わりにまとめて受け取る確実さどっちを選ぶ?」
途中経過を見たいならOnTesterPass、取りこぼしを避けて最後にまとめたいならOnTesterDeinitが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










