この記事を開いてくださったこと、心から感謝しています。MQL5でインジケーターのハンドルを作るとき、iMAとIndicatorCreateのどちらを使えばよいか迷った人も多いはずです。
結論から言うと、決まったインジケーターを手早く使いたいならiMA、種類や引数を配列で切り替えたいならIndicatorCreateが向いています。
ただし、2つのハンドルが内部で同じものとして共有されるのかは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明と公式の例をもとに、2つの関数の書き方・戻り値・仮の流れ・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
iMAとIndicatorCreateは、そもそも何が違うのか?
まずは、公式リファレンスで説明されている、2つの関数の形を整理します。
iMAは、移動平均専用の関数
MQL5公式リファレンスによると、iMAは移動平均のハンドルを返す関数です。引数は、銘柄・時間足・期間・シフト・計算方法・適用価格の6つで、バッファは1つだけです。
銘柄にNULLを渡すと現在の銘柄、時間足に0を渡すと現在の時間足になります。失敗したときは、INVALID_HANDLEが返ります。
- 引数は6つ
- バッファは1つ
- 失敗するとINVALID_HANDLEが返る
IndicatorCreateは、種類を引数で選ぶ関数
IndicatorCreateは、銘柄・時間足・インジケーターの種類・引数の数・引数の配列を受け取ります。種類にはENUM_INDICATORの値を渡し、移動平均ならIND_MAを選びます。
引数の配列にはMqlParamを並べます。公式の例では、期間・シフト・計算方法・適用価格を、TYPE_INTとして4つ入れています。公式ページによると、渡せる引数は64個までです。
- 種類はENUM_INDICATORで選ぶ
- 引数はMqlParamの配列で渡す
- 渡せる引数は64個まで
2つの書き方を、表で比べる
公式の例から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | iMA | IndicatorCreate |
|---|---|---|
| インジケーターの種類 | 移動平均だけ | IND_MAなどを選べる |
| 引数の渡し方 | 関数の引数に並べる | MqlParamの配列に入れる |
| 失敗したとき | INVALID_HANDLE | INVALID_HANDLE |
| 解放の方法 | IndicatorRelease | IndicatorRelease |
※公式の例をもとにした、筆者の整理です。
iMAで書くと、どうなるのか?
次に、手軽に書ける1つ目の方法を見ていきます。
1行で、ハンドルを作れる
iMAは、必要な値を順番に並べて呼ぶだけでハンドルを作れます。引数の名前が関数の形に出ているため、読んだだけで何を指定しているのか分かりやすいのが特徴です。
たとえば、15分足で期間8の指数移動平均を、終値で作りたい場合は、銘柄・時間足・8・0・MODE_EMA・PRICE_CLOSEの順に並べます。公式の例にも、同じ設定の記述が載っています。
- 値を順番に並べるだけ
- 引数の意味が読み取りやすい
- 公式の例にも同じ設定がある
適用価格には、別のハンドルも渡せる
公式リファレンスによると、iMAの適用価格には、価格の種類だけでなく、別のインジケーターのハンドルも渡せます。移動平均を、ほかのインジケーターの値に対して計算できる、という意味です。
デモの例は、失敗したら初期化を止める
公式のデモ例では、ハンドルがINVALID_HANDLEなら、エラーコードを表示して、初期化の失敗を返しています。そのため、無効なハンドルで、あとの処理が動くことを防げます。
- 失敗したらエラーコードを表示する
- 初期化の失敗を返して止める
IndicatorCreateで書くと、どうなるのか?
続いて、配列で組み立てる2つ目の方法を見ていきます。
引数を配列に入れてから、呼び出す
IndicatorCreateでは、先にMqlParamの配列を用意して、期間などを1つずつ入れます。そのうえで、種類と引数の数を渡して呼び出します。iMAより手順は増えますが、種類を変数にして切り替えられます。
公式のデモ例では、入力欄で、iMAを使うかIndicatorCreateを使うかを選べる作りになっています。どちらを選んでも、同じ種類のハンドルを同じ順番の引数で作っています。
- 配列を用意して値を入れる
- 種類を変数にして切り替えられる
- デモ例は2つの呼び方を選べる
カスタムインジケーターは、最初の要素が名前になる
公式ページによると、IND_CUSTOMを使うときは、配列の最初の要素をTYPE_STRINGにして、インジケーターの名前を入れます。コンパイル済みのファイルを、決められたフォルダに置く必要もあります。
テスターで使うときは、追加の指定が必要
公式ページによると、iCustomに定数の文字列で名前を書いた場合は、テスト用に自動で検出されます。IndicatorCreateのような場合は、#property tester_indicatorの指定が必要です。
たとえば、カスタムインジケーターをストラテジーテスターで使うEAなら、この指定を忘れないようにしましょう。書き忘れたときに何が起きるかは、確認したページに記載なしでした。
- 定数の名前ならテスト用に自動検出
- IndicatorCreateでは#propertyが必要
- 書き忘れた結果は記載なし
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
2つのハンドルが同じものかは、記載なし
確認した公式ページには、iMAで作ったハンドルと、IndicatorCreateで作ったハンドルが、内部で同じものとして共有されるかの説明が、ありませんでした。同じ設定で2回作ったときの扱いも、記載がありません。
そのため、どちらで作っても動作が同じだと決めつけず、自分の環境で動きを見比べてから使いましょう。
- 内部での共有は記載なし
- 同じ設定で2回作る場合も記載なし
- 環境で見比べてから使う
仮の流れで比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの書き方の手間を比べます。
例の前提を、そろえる
EAの中で、移動平均を3種類使うと仮定します。期間は5・20・50で、ほかの設定は同じものとします。
- 移動平均を3種類使う
- 期間は5・20・50
- ほかの設定は同じ
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
iMAなら、3行を並べて書く
iMAで書く場合は、期間だけを変えた呼び出しを、3行並べます。読みやすく、1行ごとの意味もはっきりしています。
- 呼び出しを3行並べる
- 変えるのは期間だけ
- 1行ごとの意味が分かりやすい
IndicatorCreateなら、配列の期間だけ入れ替えられる
IndicatorCreateで書く場合は、同じ配列の期間だけを入れ替えて、3回呼び出す書き方もできます。ただし、この書き方で手間や処理の重さがどう変わるかは、確認したページに記載なしでした。
| 流れ(仮) | iMA | IndicatorCreate |
|---|---|---|
| 期間5の作成 | iMAを1回呼ぶ | 配列を用意して呼ぶ |
| 期間20の作成 | iMAを1回呼ぶ | 期間だけ入れ替えて呼ぶ |
| 期間50の作成 | iMAを1回呼ぶ | 期間だけ入れ替えて呼ぶ |
※仮の数字にもとづく、筆者の流れの例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
決まった指標だけなら、iMAが向いている
使うインジケーターが移動平均と決まっているなら、iMAが向いています。値の取り出し方は、CopyBufferの位置指定と日時指定の比較記事で整理しています。
また、作ったハンドルの解放の考え方は、IndicatorReleaseの比較記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
関数の形に引数の意味が並んでいるため、あとからコードを読み返す人にとっても、設定の中身を追いやすくなります。チームで同じコードを読むときにも役立ちます。
種類を切り替えたいなら、IndicatorCreateが向いている
入力欄で指標の種類を切り替えたいEAや、カスタムインジケーターを使うEAなら、IndicatorCreateが向いています。種類と引数をデータとして扱えるため、同じ形のコードで複数の指標を作れます。
ただし、配列に入れる順番や型を間違えると、意図しない設定になるおそれがあります。公式の例と見比べながら、順番を確かめて書きましょう。
- 指標の種類を切り替えたい
- カスタムインジケーターを使いたい
- 引数をデータとして扱いたい
小さく試して、動きを確かめる
いきなり大きなEAで試さず、短いEAで、同じ設定を2つの書き方で作ってみましょう。作ったあとは、エラーが出ていないか、ログで確かめておくと安心です。









ログに、ハンドルの値と、GetLastErrorの結果を出しておくと、書き方の違いによる動きを、あとから落ち着いて見比べられます。
- 短いEAで2つを並べて試す
- ログでエラーを確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
IndicatorCreateのハンドルも、解放が必要なのか?
確認した公式ページには、解放が必須だという明確な書き方は、ありませんでした。ただし、公式の例では、IndicatorCreateで作った2つのハンドルを、どちらもIndicatorReleaseで解放しています。
引数の数を間違えると、どうなるのか?
確認した公式ページには、64個を超えたときの動きや、個々のエラーコードの説明が、ありませんでした。失敗した場合はINVALID_HANDLEが返る、とだけ書かれています。
- 上限超えの動きは記載なし
- エラーコードの一覧は記載なし
- 失敗時はINVALID_HANDLE
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のiMAとIndicatorCreate、引数を並べて手軽に書ける簡単さと配列で組み立てて柔軟に選べる自由さどっちを選ぶ?」
決まったインジケーターを手早く使うならiMA、種類や引数を切り替えたいならIndicatorCreateが向いています。どちらでも、失敗したときのINVALID_HANDLEを確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










