この記事を開いてくださったこと、心から感謝しています。MQL5のEAを書いていて、OnInitでどの戻り値を返せばよいか迷った人も多いはずです。
結論から言うと、環境や必要な部品がそろわず続けても意味がないならINIT_FAILED、入力した設定の組み合わせだけが不正ならINIT_PARAMETERS_INCORRECTが向いています。
ただし、実際のチャートでINIT_PARAMETERS_INCORRECTを返したときの動きは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明と公式のサンプルをもとに、4つの戻り値の意味・動き・サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
OnInitの戻り値は、そもそも何を決めるのか?
まずは、公式リファレンスで説明されている、OnInitの形と戻り値の役割を整理します。
OnInitは、intを返す形が勧められている
MQL5公式リファレンスによると、OnInitには、intを返す形と、何も返さないvoidの形があります。voidの形は古いコードとの互換のために残されていて、使うことは勧められていない、という書き方です。
voidの形では、いつも初期化に成功したものとして扱われます。つまり、途中で止めたい場合は、intの形で書く必要があります。なお「廃止された」という言葉は、確認した英語のページにはありませんでした。
- intを返す形が勧められている
- voidは互換のために残っている
- voidはいつも成功として扱われる
4つの戻り値を、表で比べる
公式ページの説明から読み取れる、4つの戻り値の違いを表にまとめます。選ぶときの目安として使ってください。
| 戻り値 | 意味 | 主な場面 |
|---|---|---|
| INIT_SUCCEEDED | 初期化に成功した(0と同じ) | 問題がないとき |
| INIT_FAILED | 避けられない失敗 | 必要な部品が作れないとき |
| INIT_PARAMETERS_INCORRECT | 入力の組み合わせが不正 | 設定値がおかしいとき |
| INIT_AGENT_NOT_SUITABLE | そのエージェントが不向き | メモリ不足など |
※公式の説明をもとにした、筆者の整理です。
0以外を返すと、失敗として扱われる
公式ページによると、intの形で0以外を返すと、初期化の失敗として扱われます。失敗したときは、終了のイベントが、初期化失敗を示す理由つきで発生します。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
INIT_FAILEDを返すと、どうなるのか?
次に、避けられない失敗を表す、1つ目の戻り値を見ていきます。
続けても意味がないときに、使う
公式リファレンスによると、INIT_FAILEDは「避けられないエラーのため、テストを続けても意味がない」という場面で使います。公式の例として、EAに必要なインジケーターが作れない場合が挙げられています。
0以外の値を返すことと同じ扱いで、テスターでは初期化の失敗になります。言い換えると、設定のせいではなく、環境や部品のせいで先に進めないときの合図です。
- 必要な部品が作れないとき
- 0以外の値と同じ扱い
- テスターでは初期化の失敗
チャートとテスターで、動きが違う
公式ページによると、チャート上のEAは強制的に外されます。インジケーターは外されず、チャートに残りますが、動かない状態になり、イベントの処理も呼ばれません。
最適化のテストでは、EAはエージェントのメモリから外され、次の組み合わせのために読み込み直されます。公式ページには、この手順はTesterStopを呼ぶよりずっと時間がかかる、とあります。
| 場面 | INIT_FAILEDのときの動き |
|---|---|
| チャート上のEA | 強制的に外される |
| インジケーター | 残るが動かない |
| 最適化のテスト | 外されて読み込み直し |
※公式の説明から読み取れる内容を、筆者が整理しました。
INIT_PARAMETERS_INCORRECTを返すと、どうなるのか?
続いて、入力の組み合わせが不正なときに使う、2つ目の戻り値を見ていきます。
入力の組み合わせが不正なときに、使う
公式リファレンスによると、INIT_PARAMETERS_INCORRECTは、プログラムを作った人が「入力した設定の組み合わせが不正だ」と示すために使います。公式のサンプルでも、期間の入力が0以下のときに返しています。
- 入力の値が不正なとき
- 作った人が自分で判断して返す
- サンプルでは期間が0以下のとき
最適化では、その組み合わせだけが除外される
公式ページによると、最適化の結果の表では、この戻り値の行が赤く強調されます。その組み合わせのテストは行われず、エージェントはすぐ次の仕事を受け取れます。
また、テスターはその仕事を、ほかのエージェントにやり直させることはしません。遺伝的アルゴリズムでは、その組み合わせは次の世代づくりから外されます。
除外が多すぎると、結果がゆがむ
公式ページには、除外される組み合わせが多すぎると、最適化の結果がゆがむ可能性がある、という注意があります。探し方は、評価の値に抜けがなく、なめらかだと考えて進むためです。
たとえば、短い期間が長い期間より大きい組み合わせばかりを除外すると、探す範囲が大きく欠けます。入力の範囲は、はじめから不正が少なくなるように決めておくと安心です。
- 除外が多いと結果がゆがむ
- 評価の抜けは少ないほうがよい
- 入力の範囲を先に整える
チャート上での動きは、確認できなかった
チャート上のEAでINIT_PARAMETERS_INCORRECTを返したとき、外されるのかどうかは、確認した公式ページに記載なしでした。公式の説明は、テスターでの動きについてだけ書かれています。
INIT_AGENT_NOT_SUITABLEとは、何なのか?
残る1つは、プログラムではなく、動かす側の事情を表す戻り値です。
エージェントが不向きなときに、使う
公式リファレンスによると、INIT_AGENT_NOT_SUITABLEは、プログラムにエラーはないものの、そのエージェントがテストに向かない場合に使います。公式の例は、メモリが足りない場合や、OpenCLに対応していない場合です。
この戻り値を返したエージェントは、その最適化が終わるまで、新しい仕事を受け取りません。事前に確かめたいときは、OnInitの中でTerminalInfoIntegerを使って、エージェントの資源を調べるとよい、と書かれています。
- メモリ不足など動かす側の事情
- 最適化の終了まで仕事を受け取らない
- TerminalInfoIntegerで資源を調べる
公式のサンプルは、どう組み立てられているのか?
公式のサンプルは、4つの戻り値を順番に使い分ける形になっています。流れを整理します。
サンプルの流れを、順に見る
公式のサンプルは、まず期間の入力が0以下なら、INIT_PARAMETERS_INCORRECTを返します。次に、最適化中でメモリが足りなければ、INIT_AGENT_NOT_SUITABLEを返します。
そのあと、カスタムインジケーターのハンドルを作り、失敗したらエラーの番号を表示してINIT_FAILEDを返します。すべて通れば、INIT_SUCCEEDEDを返す、という順番です。
| 順番 | 確かめること | 返す値 |
|---|---|---|
| 1 | 期間の入力が0以下か | INIT_PARAMETERS_INCORRECT |
| 2 | 最適化中にメモリが足りるか | INIT_AGENT_NOT_SUITABLE |
| 3 | インジケーターを作れたか | INIT_FAILED |
| 4 | すべて通った | INIT_SUCCEEDED |
※公式のサンプルをもとにした、筆者の整理です。
メッセージを出すのは、自分で書く
公式のサンプルは、PrintFormatで理由を自分で表示しています。戻り値ごとにどのメッセージがログに出るのかは、確認したページに記載なしでした。そのため、理由は自分で書いて残すのが安心です。
たとえば、後始末の考え方は、IndicatorReleaseとOnDeinitの比較記事で整理しています。
- 理由は自分で表示する
- ログの出方は記載なし
- 後始末も合わせて考える
どう使い分ければよいのか?
ここまでの特徴をふまえて、目的別の使い分けを考えます。
環境や部品の問題なら、INIT_FAILEDを選ぶ
必要な部品が作れない、読み込めないといった、設定を変えても直らない問題なら、INIT_FAILEDが向いています。ただし、最適化では読み込み直しに時間がかかる点に、気をつけてください。
また、成績の評価を返す側の書き方は、OnTesterの比較記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
設定値の問題なら、INIT_PARAMETERS_INCORRECTを選ぶ
入力の組み合わせだけがおかしいなら、INIT_PARAMETERS_INCORRECTが向いています。最適化では、その組み合わせだけが除外され、全体のテストは続くためです。
そのぶん、除外が多すぎる点に注意が必要です。まずは、入力の範囲を整えて、不正な組み合わせを減らすところから始めると、迷いにくくなります。
- 入力の組み合わせが不正
- 全体のテストは続けたい
- 除外が多すぎないようにする
小さく試して、動きを確かめる
いきなり長い最適化を回さず、短い範囲で、わざと不正な入力を入れて、結果の表の見え方を確かめてみましょう。ただし、チャート上での動きは記載なしなので、デモ口座で確かめてください。









理由のメッセージと入力の値を並べてログに出しておくと、どの組み合わせで止まったのかを、あとから落ち着いて確かめられます。
- 短い範囲で試す
- わざと不正な入力を入れる
- 理由と入力の値をログに出す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
OnInitに時間の制限はあるのか?
確認した公式ページには、OnInitの時間の制限について、説明がありませんでした。なお、OnDeinitには2.5秒の制限があると、別のページに書かれています。
戻り値の数値は、いくつなのか?
確認したページには、INIT_SUCCEEDEDが0と同じであることは書かれていましたが、ほかの戻り値の数値は記載なしでした。数値ではなく、名前の付いた値を使って書くと、読み間違いが減ります。
- 成功は0と同じ
- ほかの数値は記載なし
- 名前の付いた値を使う
この記事の説明は、実際の結果なのか?
公式ページの説明を整理したものです。実際の動きは、使っている環境や版によって異なる場合があるため、最新の公式情報で確かめてください。
- 公式の説明の整理
- 環境や版で異なる場合がある
まとめ:「MQL5のOnInitの戻り値、INIT_FAILEDで止める確実さとINIT_PARAMETERS_INCORRECTで入力だけ除外する細やかさどっちを選ぶ?」
環境や部品の問題で続けても意味がないならINIT_FAILED、入力の組み合わせだけが不正ならINIT_PARAMETERS_INCORRECTが向いています。理由は、自分で書いて残しましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










