MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のOnInitの戻り値、INIT_FAILEDで止める確実さとINIT_PARAMETERS_INCORRECTで入力だけ除外する細やかさどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のOnInitの戻り値、INIT_FAILEDで止める確実さとINIT_PARAMETERS_INCORRECTで入力だけ除外する細やかさどっちを選ぶ?

2026 11/17
PR
FX自動売買と人工知能
2026年11月17日
MQL5のOnInitの戻り値、INIT_FAILEDで止める確実さとINIT_PARAMETERS_INCORRECTで入力だけ除外する細やかさどっちを選ぶ?

この記事を開いてくださったこと、心から感謝しています。MQL5のEAを書いていて、OnInitでどの戻り値を返せばよいか迷った人も多いはずです。

結論から言うと、環境や必要な部品がそろわず続けても意味がないならINIT_FAILED、入力した設定の組み合わせだけが不正ならINIT_PARAMETERS_INCORRECTが向いています。

ただし、実際のチャートでINIT_PARAMETERS_INCORRECTを返したときの動きは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。

この記事では、MQL5公式リファレンスの説明と公式のサンプルをもとに、4つの戻り値の意味・動き・サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。

MQL5のOnInitの戻り値INIT_FAILEDとINIT_PARAMETERS_INCORRECTの違いをまとめたインフォグラフィック
目次

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以外を返すと、初期化の失敗として扱われます。失敗したときは、終了のイベントが、初期化失敗を示す理由つきで発生します。

  • 0は成功
  • 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が向いています。最適化では、その組み合わせだけが除外され、全体のテストは続くためです。

そのぶん、除外が多すぎる点に注意が必要です。まずは、入力の範囲を整えて、不正な組み合わせを減らすところから始めると、迷いにくくなります。

  • 入力の組み合わせが不正
  • 全体のテストは続けたい
  • 除外が多すぎないようにする

小さく試して、動きを確かめる

いきなり長い最適化を回さず、短い範囲で、わざと不正な入力を入れて、結果の表の見え方を確かめてみましょう。ただし、チャート上での動きは記載なしなので、デモ口座で確かめてください。

INIT_FAILEDは、続けても意味がない場面の合図だと分かって、迷いが減りました。
不正な組み合わせだけが赤く除外されると知って、安心して最適化を回せました。うれしいです。
Kenichi
Kenichi
除外が多いと結果がゆがむと知って、入力の範囲を先に見直しました。調べておいてよかったです。
4つを並べて見たら、使い分けが整理されて、落ち着いてコードを書けるようになりました。

理由のメッセージと入力の値を並べてログに出しておくと、どの組み合わせで止まったのかを、あとから落ち着いて確かめられます。

  • 短い範囲で試す
  • わざと不正な入力を入れる
  • 理由と入力の値をログに出す

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

OnInitに時間の制限はあるのか?

確認した公式ページには、OnInitの時間の制限について、説明がありませんでした。なお、OnDeinitには2.5秒の制限があると、別のページに書かれています。

  • OnInitの制限は記載なし
  • OnDeinitは2.5秒の制限

戻り値の数値は、いくつなのか?

確認したページには、INIT_SUCCEEDEDが0と同じであることは書かれていましたが、ほかの戻り値の数値は記載なしでした。数値ではなく、名前の付いた値を使って書くと、読み間違いが減ります。

  • 成功は0と同じ
  • ほかの数値は記載なし
  • 名前の付いた値を使う

この記事の説明は、実際の結果なのか?

公式ページの説明を整理したものです。実際の動きは、使っている環境や版によって異なる場合があるため、最新の公式情報で確かめてください。

  • 公式の説明の整理
  • 環境や版で異なる場合がある

まとめ:「MQL5のOnInitの戻り値、INIT_FAILEDで止める確実さとINIT_PARAMETERS_INCORRECTで入力だけ除外する細やかさどっちを選ぶ?」

環境や部品の問題で続けても意味がないならINIT_FAILED、入力の組み合わせだけが不正ならINIT_PARAMETERS_INCORRECTが向いています。理由は、自分で書いて残しましょう。

  • 部品の問題ならINIT_FAILED
  • 設定値の問題ならINIT_PARAMETERS_INCORRECT
  • 理由は自分で書いて残す

仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • MQL5 リファレンス(OnInit)
  • MQL5 リファレンス(イベントの発生)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のOnTradeとOnTradeTransaction、一覧の変化をまとめて確かめる簡単さと取引の段階ごとに受け取る細かさどっちを選ぶ?
  • MQL5のOnChartEvent、標準イベントでクリックやキー入力を受ける手軽さとEventChartCustomで自作イベントを送る自由さどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    2026年11月17日
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
    2026年11月17日
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    2026年11月17日
  • MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    2026年11月17日
  • MQL5のExpertRemoveとIsStoppedの比較
    MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?
    2026年11月17日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次