この記事を開いてくださったこと、心から感謝しています。MQL5のEAの最適化で、入力値の範囲を自動で調整したいと考えた人も多いはずです。
結論から言うと、範囲や刻みを自分で決め直したいならParameterSetRange、今の範囲を読み取って判断に使いたいならParameterGetRangeが向いています。
ただし、一部の細かい動きは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の仕組み・動き方・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ParameterSetRangeとParameterGetRangeは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。
ParameterSetRangeは、範囲と刻みを指定する
MQL5公式リファレンスによると、ParameterSetRangeは、ストラテジーテスターでEAを最適化するときの、入力変数の扱いを指定する関数です。値・刻み・開始値・終了値を決められます。
引数は、変数の名前、最適化に使うかどうかのフラグ、値、開始値、刻み、終了値の6つです。整数用と小数用の2つの形があります。
- 名前・有効フラグ・値・開始・刻み・終了を渡す
- 整数用と小数用の2つの形がある
- 最適化から外すこともできる
ParameterGetRangeは、今の範囲を読み取る
ParameterGetRangeは、同じ6つの項目を、読み取るための関数です。最適化のときの入力変数について、値の範囲と刻みを取得します。
読み取る側の引数は、参照で渡す形です。こちらも、整数用と小数用の2つの形があります。
- 同じ6つの項目を読み取る
- 引数は参照で受け取る
- 整数用と小数用の2つの形がある
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ParameterSetRange | ParameterGetRange |
|---|---|---|
| 役割 | 範囲と刻みを指定する | 範囲と刻みを読み取る |
| 呼べる場所 | OnTesterInitのみ | OnTesterInit・OnTesterPass・OnTesterDeinit |
| 戻り値 | bool(成功したか) | bool(成功したか) |
| 対象の変数 | inputとsinput | input(ページの表記) |
※公式の説明をもとにした、筆者の整理です。
呼べる場所には、どんな決まりがあるのか?
次に、2つの関数を呼べる場所の決まりを見ていきます。ここを間違えると、呼び出しが失敗する可能性があります。
ParameterSetRangeは、OnTesterInitからだけ呼べる
公式ページには、ParameterSetRangeは、ストラテジーテスターで最適化を始めるときの、OnTesterInitの中からだけ呼べる、と書かれています。
また、テスターの設定にかかわらず、ある入力変数を最適化から完全に外せる、とも書かれています。sinputで宣言した変数も、最適化に使えるようになります。
- OnTesterInitの中からだけ呼べる
- 最適化から完全に外せる
- sinputの変数も最適化に使える
ParameterGetRangeは、3つの場所から呼べる
ParameterGetRangeは、OnTesterInit・OnTesterPass・OnTesterDeinitの3つから呼べる、と書かれています。最適化の結果を処理する場面でも、読み取れるわけです。
OnTesterInitで読み取った値は、ParameterSetRangeで列挙のルールを決め直すために使える、とも書かれています。
OnTesterPassとOnTesterDeinitの使い分けは、OnTesterPassとOnTesterDeinitの記事で整理しています。
| 関数 | 呼べる場所 |
|---|---|
| ParameterSetRange | OnTesterInit |
| ParameterGetRange | OnTesterInit・OnTesterPass・OnTesterDeinit |
※公式の説明から読み取れる内容を、筆者が整理しました。
細かい動きは、確認できなかった
存在しない名前を渡したときの動きは、確認したページに記載なしでした。開始値が終了値より大きいときや、刻みが0以下のときの動きも、記載なしです。
有効フラグをfalseにしたとき、開始値や刻みが無視されるのかも、ページには書かれていませんでした。エラーコードの種類も、記載なしです。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
OnTesterInitには、どんな決まりがあるのか?
2つの関数は、OnTesterInitと深く結びついています。ここで、OnTesterInit自体の決まりも整理します。
最適化を始める前に呼ばれ、時間に限りがある
公式ページによると、OnTesterInitのイベントは、ストラテジーテスターでの最適化が始まる前に発生します。このハンドラは、OnTesterDeinitといっしょに使われる、と書かれています。
また、実行時間には限りがあり、超えるとEAが強制的に止められて、最適化そのものも取り消されます。具体的な秒数は、ページに記載なしでした。
- 最適化の開始前に呼ばれる
- OnTesterDeinitといっしょに使う
- 時間を超えると最適化が取り消される
戻り値のあるint版が、推奨されている
OnTesterInitには、int型を返す形と、何も返さない形があります。公式ページでは、int型を返す形が推奨されています。早い段階で最適化を止めたいとき、エラーの値を返せるからです。
INIT_SUCCEEDED以外の値を返すと、エラーとして扱われ、最適化は始まりません。何も返さない形は、古いコードとの互換のためだけに残されている、と書かれています。
最適化に関わるほかの関数との違いは、OnTesterとTesterStatisticsの記事でも整理しています。
| 形 | 公式ページでの扱い |
|---|---|
| int OnTesterInit | 推奨されている |
| void OnTesterInit | 互換のためだけに残されている |
※公式の説明から読み取れる内容を、筆者が整理しました。
公式のサンプルは、どう書かれているのか?
ここでは、公式ページにあるサンプルを見ていきます。実は、ParameterSetRangeのページそのものには、サンプルがありません。
ParameterGetRangeのサンプルは、4種類の入力を読み取る
ParameterGetRangeのページのサンプルは、整数・小数・真偽・列挙型の4つの入力を、順に読み取って表示する内容です。真偽と列挙型も、整数用の形で読み取っています。
ただし、真偽や列挙型が整数用の形で使えることは、ページの説明には記載なしでした。サンプルがそう書いている、という事実だけが読み取れます。
- 整数・小数・真偽・列挙型の4種類を読む
- 真偽と列挙型も整数用の形で読む
- 戻り値は確認していない
ParameterSetRangeは、OnTesterInitのサンプルに出てくる
ParameterSetRangeを実際に呼んでいるのは、OnTesterInitのページのサンプルです。入力ごとに、有効にするか外すかと、開始値・刻み・終了値を設定しています。
たとえば、ATRの倍率は有効にして、1.0から7.0まで0.3刻みで動かす設定です。ロット数や、スリッページなどは、有効にしない設定になっています。
| 入力(サンプル) | 設定の内容 |
|---|---|
| kATR | 有効にして1.0から7.0まで0.3刻み |
| ATRperiod | 有効にして15から30まで1刻み |
| holdbars | 有効にして3から15まで1刻み |
| lots・slippage | 有効にしない |
※公式のサンプルの内容を、筆者が整理しました。
ここから読み取れることと、読み取れないこと
サンプルから、有効にしない入力は、範囲の引数に0を渡している、という書き方が読み取れます。ただし、それが必須かどうかは、記載なしでした。
| 確認できること | 確認できないこと |
|---|---|
| 外す入力は範囲に0を渡している | 0を渡すことが必須かどうか |
| 戻り値は確認していない | 失敗したときの具体的な動き |
※公式の説明から読み取れる内容を、筆者が整理しました。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。
例の前提を、そろえる
あるEAに、期間の入力と倍率の入力があり、期間が短いときだけ、倍率の範囲を狭めたい場合を考えます。
- 期間と倍率の2つの入力がある
- 期間が短いときは倍率の範囲を狭めたい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
読み取ってから、決め直す
まず、ParameterGetRangeで、期間の今の範囲を読み取ります。その値を見て、短いと判断できたら、ParameterSetRangeで倍率の範囲を狭めます。公式の説明も、この流れを想定しています。
- GetRangeで今の範囲を読む
- 値を見て条件を判断する
- SetRangeで範囲を決め直す
固定したいだけなら、SetRangeだけで足りる
最適化に使わない入力を決めているなら、読み取る必要はありません。ParameterSetRangeで、有効フラグをfalseにする書き方が考えられます。
| 場面(仮) | 向いている書き方 |
|---|---|
| 今の範囲を見て判断する | ParameterGetRange |
| 範囲を決め直す | ParameterSetRange |
| 最初から固定する | ParameterSetRange |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
自由さを優先するなら、ParameterSetRangeを選ぶ
範囲や刻みを、コードの中で決め直したいときは、ParameterSetRangeが向いています。テスターの画面の設定に頼らず、条件ごとに変えられます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
確かさを優先するなら、ParameterGetRangeを選ぶ
今の範囲を確かめてから判断したいときは、ParameterGetRangeが向いています。最適化の結果を処理する場所でも、読み取れるのが特徴です。
- 今の設定を確かめたい
- 条件に応じて処理を変えたい
- 結果の処理でも範囲を知りたい
小さく試して、動きを確かめる
いきなり本番の最適化で使わず、入力が少ない小さなEAで、読み取った値を表示するだけの確認から始めましょう。そのあとで、範囲を変える処理を足していくと、違いがよく分かります。









もう1つのコツは、戻り値を必ず確認して、falseのときはGetLastErrorで理由を調べることです。公式のサンプルは戻り値を見ていないため、自分のコードでは、確認を足しておくと安心です。
- 戻り値を確認する
- falseのときはGetLastErrorを見る
- OnTesterInitは時間をかけすぎない
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ParameterSetRangeは、どこで呼べるのか?
公式ページによると、OnTesterInitの中からだけ呼べます。ほかの場所から呼べるかどうかは、確認したページに記載なしでした。
- OnTesterInitの中からだけ呼べる
- 最適化のときだけ使う
ParameterGetRangeは、どこで呼べるのか?
OnTesterInit・OnTesterPass・OnTesterDeinitの3つから呼べる、と書かれています。最適化の結果を扱う場面でも、使えます。
- 3つのハンドラから呼べる
- OnTesterInitで読んで決め直せる
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のParameterSetRangeとParameterGetRange、最適化の範囲や刻みを自分で決め直せる自由さと今の範囲を読み取って判断に使える確かさどっちを選ぶ?」
範囲や刻みを決め直すならParameterSetRange、今の範囲を読み取って判断するならParameterGetRangeが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










