ENUM_INIT_RETCODE アーカイブ - 自動売買を作ろう！

【MQL4関数】OnInit関数とは？自動売買の初期化に使われるイベント関数

朝日奈りさ — Sun, 15 May 2022 02:51:39 +0000

朝日奈りさ

OnInit関数は、自動売買の初期化に使われるイベント関数です。OnInit関数は、自動売買を起動すると、自動的に一度だけ実行される関数です。そのため、変数の初期化などの処理に使うと良いでしょう。

OnInit関数とは

「自動売買の変数を初期化したい！」

という方は、OnInit関数を使ってみましょう！

OnInit関数は、イベント関数の一つで、自動売買が起動したときに、自動的に一度だけ実行される関数です。

そのため、自動売買開発者の多くの方が、変数の初期化などの処理に使っています。

また、OnInit関数は、自動売買（エキスパートアドバイザ）を新規作成すると、自動的にプログラミングされています。

自動的にプログラミングされているのは、主に以下の3つなので、確認しておくと良いでしょう。

今回は、OnInit関数に注目して解説していきます。

自動売買を新規作成したときのプログラム

自動売買を新規作成すると、以下のようなプログラムが自動作成されます。

//+------------------------------------------------------------------+
//|                                             newExpertAdviser.mq4 |
//|                                     Copyright 2022, Asahina Risa |
//|                                      https://mql-programing.com/ |
//+------------------------------------------------------------------+
#property copyright "Copyright 2022, Asahina Risa"
#property link      "https://mql-programing.com/"
#property version   "1.00"
#property strict
//+------------------------------------------------------------------+
//| Expert initialization function                                   |
//+------------------------------------------------------------------+
int OnInit()
  {
//---
   
//---
   return(INIT_SUCCEEDED);
  }
//+------------------------------------------------------------------+
//| Expert deinitialization function                                 |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
  {
//---
   
  }
//+------------------------------------------------------------------+
//| Expert tick function                                             |
//+------------------------------------------------------------------+
void OnTick()
  {
//---
   
  }
//+------------------------------------------------------------------+

このように、すでにOnInit関数・OnDeinit関数・OnTick関数が記述されています。

OnInit関数は、13行目にあります。

OnInit関数の特徴

OnInit関数はイベント関数なので、イベントが起こったときに実行されます。

そのイベントとは、「自動売買が起動したとき」です。

つまり、自動売買をチャートにドラッグアンドドロップしたときに、一度だけ実行されます。

そのため、OnInit関数は、変数などのパラメータの初期化をするために使用されることが多いです。

別名「初期化関数」（initialization function）とも呼ばれる関数です。

OnInit関数の書き方

OnInit関数の使い方は、基本的な関数と同じです。

関数をマスターしていない方はこちらの記事が参考になります。

【MQLプログラミング基礎】関数は難しい？関数の使い方を理解しよう！プログラム例あり

関数とは？「プログラムは、何度も同じことを書かないといけない」と思っている方、ぜひ関数を使ってみてください。関数とは、何度も繰り返すプログラムを、まとめた状態のものです。事前に、まとまりを作っておくことで、同じプ

基本的な書き方

OnInit関数はとてもシンプルな関数です。

引数なしで実行できます。

戻り値はint型ですが、以下のプログラムの4行目にあるように、「INIT_SUCCEEDED」という定数を戻すことが多いです。

INIT_SUCCEEDED定数は、「OnInit関数が正常に終了しました。」ということを表している定数なので、このまま使用して問題ありません。

逆に異常終了した場合は、INIT_FAILED定数を使用しましょう。

OnInit関数の基本的な書き方は以下の通りです。

int OnInit()
  {
   //初期化したい変数などを記述
   return(INIT_SUCCEEDED);
  }

戻り値は int型なので、returnで値を戻すようにしましょう。

戻す値は、定数が用意されています。

OnInit関数の戻り値はこちらの記事が詳しいので、よろしければどうぞ。

【MQL4定数】初期化関数の戻り値の定数（ENUM_INIT_RETCODE）

初期化関数の戻り値の定数（ENUM_INIT_RETCODE）初期化関数の戻り値の定数（ENUM_INIT_RETCODE）は、OnInit関数の戻り値として使われる定数です。初期化が成功したのか、失敗したのかを戻す

戻り値

int型（ENUM_INIT_RETCODE）

引数

なし

OnInit関数のサンプルプログラム

サンプルプログラムは、こちらになります。

このプログラムには4つの機能を実装しております。

パラメータの異常検知
メモリの異常検知
関数の異常検知
正常終了

//異常値を検出するためのパラメータ
input int ma_period=10;

int OnInit()
  {


   //パラメータが異常かどうかをチェック
   if(ma_period <= 0)
     {
      //パラメータが異常なので、INIT_PARAMETERS_INCORRECT定数を戻す
      return (INIT_PARAMETERS_INCORRECT);
     }


   //メモリに異常がないかチェック
   int memory = TerminalInfoInteger(TERMINAL_MEMORY_TOTAL);
   if(memory < 2000)
     {
      //メモリが異常なので、INIT_AGENT_NOT_SUITABLE定数を戻す
      return (INIT_AGENT_NOT_SUITABLE);
     }


   //その他異常がないかチェック
   double ma = iMA(Symbol(), PERIOD_CURRENT, 14, 0, MODE_SMA, PRICE_CLOSE, 0);
   if(ma <= 0)
     {
      //値が異常なので、INIT_FAILED定数を戻す
      return(INIT_FAILED);
     }


   //正常なので、INIT_SUCCEEDED定数を戻す
   return(INIT_SUCCEEDED);
  }

このサンプルプログラムでは、OnInit関数の中で以下の処理を行っています。

9行目：入力パラメータ「ma_period」が0以下の場合、INIT_PARAMETERS_INCORRECT定数を返して異常終了します。
18行目：TerminalInfoInteger関数でメモリ情報を取得し、2000MB未満であればINIT_AGENT_NOT_SUITABLE定数を返します。
27行目：iMA関数で移動平均値を取得し、値が0以下であればINIT_FAILED定数を返します。
35行目：すべてのチェックを通過した場合、INIT_SUCCEEDED定数を返して正常終了します。

サンプルプログラムはこちら

まとめ

OnInit関数は、自動売買を起動すると一度だけ実行されるイベント関数です。

自動売買を、チャートにドラッグアンドドロップすると実行されます。

そのため、パラメータの初期化などに使用されることが多いので、サンプルプログラムを参考にして、プログラミングしてみてください。

ちなみに、OnInit関数は、自動的に実行されますが、手動で実行することも可能です。

他の関数と同じように、OnInit関数を呼び出すことで、実行できますので、プログラムの途中で初期化したいときに実行すると良いでしょう。

MQL4サンプルプログラム

朝日奈りさ作成したMQL4サンプルプログラムの一覧です。当サイトは、MQL4のサンプルプログラムを公開しています。プログラムの内容を見たり、変更したりできます。　当サイトはMQLプログラミングを学習するサイトです。ご利用の際には、プライバシ

【MQL4プログラミング】自動売買の作り方！FXで使えるテンプレートあり

はじめにこの記事は、MQLプログラミング基礎を理解している方向けに作成しております。もしMQLプログラミングがわからないという方は、先に以下の記事を読んでおくことをオススメします。カテゴリー：MQLプログラミング基

MQL4リファレンス【全データ一覧】

/*! elementor - v3.6.5 - 27-04-2022 */.e-container.e-container--row .elementor-spacer-inner{width:var(--spacer-size)}.e-

投稿【MQL4関数】OnInit関数とは？自動売買の初期化に使われるイベント関数は自動売買を作ろう！に最初に表示されました。

【MQL4定数】初期化関数の戻り値の定数（ENUM_INIT_RETCODE）

朝日奈りさ — Sun, 15 May 2022 02:34:58 +0000

初期化関数の戻り値の定数（ENUM_INIT_RETCODE）

初期化関数の戻り値の定数（ENUM_INIT_RETCODE）は、OnInit関数の戻り値として使われる定数です。

初期化が成功したのか、失敗したのかを戻すことができます。

初期化関数の戻り値の定数（ENUM_INIT_RETCODE）

定数	説明
INIT_SUCCEEDED	初期化成功
INIT_FAILED	初期化失敗
INIT_PARAMETERS_INCORRECT	パラメータに異常値が代入されている
INIT_AGENT_NOT_SUITABLE	メモリ不足などの問題が発生

初期化関数の戻り値の定数の使い方

主に、OnInit関数で使用されます。

OnInit関数の戻り値として記述します。

システムで自動的に戻る定数ではなく、開発者が戻す定数なので、戻す定数を間違えないように注意しましょう。

例えば、以下のように使用します。

//異常値を検出するためのパラメータ
input int ma_period=10;

int OnInit()
  {


   //パラメータが異常かどうかをチェック
   if(ma_period <= 0)
     {
      //パラメータが異常なので、INIT_PARAMETERS_INCORRECT定数を戻す
      return (INIT_PARAMETERS_INCORRECT);
     }


   //メモリに異常がないかチェック
   int memory = TerminalInfoInteger(TERMINAL_MEMORY_TOTAL);
   if(memory < 2000)
     {
      //メモリが異常なので、INIT_AGENT_NOT_SUITABLE定数を戻す
      return (INIT_AGENT_NOT_SUITABLE);
     }


   //その他異常がないかチェック
   double ma = iMA(Symbol(), PERIOD_CURRENT, 14, 0, MODE_SMA, PRICE_CLOSE, 0);
   if(ma <= 0)
     {
      //値が異常なので、INIT_FAILED定数を戻す
      return(INIT_FAILED);
     }


   //正常なので、INIT_SUCCEEDED定数を戻す
   return(INIT_SUCCEEDED);
  }

ほとんどの場合、成功（INIT_SUCCEEDED）と異常（INIT_FAILED）の定数を使えば良いので、この2つを覚えておくと良いでしょう。

サンプルプログラム

以下は、初期化関数の戻り値の定数（ENUM_INIT_RETCODE）を活用したEAのサンプルプログラムです。

OnInit関数内で各種チェックを行い、適切な定数を返しています。初期化に成功した場合のみOnTick関数で移動平均線の値をログに出力します。

//+------------------------------------------------------------------+
//| ENUM_INIT_RETCODE サンプルプログラム                              |
//+------------------------------------------------------------------+
#property strict

//--- 入力パラメータ
input int    InpMaPeriod   = 14;    // 移動平均の期間
input double InpLotSize    = 0.1;   // ロットサイズ

//--- グローバル変数
double g_maValue;

//+------------------------------------------------------------------+
//| 初期化関数                                                        |
//+------------------------------------------------------------------+
int OnInit()
  {
   //--- パラメータが異常かどうかをチェック
   if(InpMaPeriod <= 0)
     {
      Print("エラー: 移動平均の期間が不正です。期間=", InpMaPeriod);
      return(INIT_PARAMETERS_INCORRECT);
     }

   //--- ロットサイズが異常かどうかをチェック
   if(InpLotSize <= 0 || InpLotSize > 10.0)
     {
      Print("エラー: ロットサイズが不正です。ロット=", InpLotSize);
      return(INIT_PARAMETERS_INCORRECT);
     }

   //--- メモリに異常がないかチェック
   int memory = TerminalInfoInteger(TERMINAL_MEMORY_TOTAL);
   if(memory < 2000)
     {
      Print("エラー: メモリが不足しています。メモリ=", memory, "MB");
      return(INIT_AGENT_NOT_SUITABLE);
     }

   //--- 移動平均の値を取得してチェック
   g_maValue = iMA(Symbol(), PERIOD_CURRENT, InpMaPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);
   if(g_maValue <= 0)
     {
      Print("エラー: 移動平均の値が取得できませんでした。");
      return(INIT_FAILED);
     }

   //--- すべてのチェックに問題なし
   Print("初期化成功: 移動平均期間=", InpMaPeriod, " ロット=", InpLotSize);
   return(INIT_SUCCEEDED);
  }

//+------------------------------------------------------------------+
//| ティック関数                                                      |
//+------------------------------------------------------------------+
void OnTick()
  {
   //--- 移動平均の最新値を取得
   g_maValue = iMA(Symbol(), PERIOD_CURRENT, InpMaPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);

   //--- 現在の価格と移動平均の値をログに出力
   double currentPrice = Close[0];
   Print("現在価格=", currentPrice, " 移動平均=", g_maValue);

   //--- 価格が移動平均より上か下かを判定
   if(currentPrice > g_maValue)
     {
      Print("現在価格は移動平均より上です（買いシグナル）");
     }
   else
     {
      Print("現在価格は移動平均より下です（売りシグナル）");
     }
  }

//+------------------------------------------------------------------+
//| 終了関数                                                          |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
  {
   Print("EAを終了します。理由コード=", reason);
  }

このサンプルでは、OnInit関数内で以下の4つのチェックを行っています。

移動平均の期間チェック：0以下の場合はINIT_PARAMETERS_INCORRECTを返す
ロットサイズのチェック：0以下または10を超える場合はINIT_PARAMETERS_INCORRECTを返す
メモリのチェック：メモリが不足している場合はINIT_AGENT_NOT_SUITABLEを返す
移動平均値の取得チェック：値が取得できない場合はINIT_FAILEDを返す

すべてのチェックに問題がなければ、INIT_SUCCEEDEDを返して正常に初期化が完了します。

【補足】初期化関数の戻り値の定数の列挙型（ENUM_INIT_RETCODE）

初期化関数の戻り値の定数は、ENUM_INIT_RETCODEという列挙型に含まれています。

列挙型は、定数群をひとまとめにしたものです。

以下のように使います。

ENUM_INIT_RETCODE initRetcode = INIT_SUCCEEDED;

上記のようにプログラムすると、initRetcode変数に INIT_SUCCEEDEDの値が代入されます。

サンプルプログラムはこちら

【MQLプログラミング基礎】列挙型とは？配列との違いを理解して使いこなそう！

列挙型とは？「文字を数値に変換できたら便利なのになぁ」という方は、列挙型を使ってみましょう！列挙型は、「文字列と数値」の組み合わせを設定できる型です。例えば、列挙型に「December」と入力すると「12」が返っ

【MQL4プログラミング】自動売買の作り方！FXで使えるテンプレートあり

MQL4リファレンス【全データ一覧】

/*! elementor - v3.6.5 - 27-04-2022 */.e-container.e-container--row .elementor-spacer-inner{width:var(--spacer-size)}.e-

投稿【MQL4定数】初期化関数の戻り値の定数（ENUM_INIT_RETCODE）は自動売買を作ろう！に最初に表示されました。