MQL5インジケーター関数辞典｜iCustom・CopyBuffer・SetIndexBuffer・OnCalculate一覧

MQL5でインジケーター開発やEA連携を行う場合、まず理解しておきたいのが、iCustom、CopyBuffer、IndicatorRelease、SetIndexBuffer、OnCalculate、PlotIndexSetInteger、ArraySetAsSeries、buffer index、shift の関係です。

インジケーター側では、OnCalculateで計算し、SetIndexBufferでバッファを割り当て、PlotIndexSet系で描画設定を行います。EA側では、iCustomや標準インジケーター関数でハンドルを作成し、CopyBufferで必要な値を読み取ります。

この記事では、MQL5のインジケーター関数を、EA開発や不具合調査で確認しやすい辞典形式で整理します。公式リファレンスの代わりに丸暗記するためではなく、どの関数を、どの場面で使い、どの戻り値とログを確認するかを整理するための記事です。

注意：この記事はMQL5開発・インジケーター開発・EA連携・不具合調査のための技術解説です。特定の売買判断、推奨エントリー、推奨ロット、推奨銘柄、利益保証、勝率保証、損失回避保証を行うものではありません。実運用前には、必ずデモ環境や検証環境で動作を確認してください。

MQL5インジケーター関数の全体像

MQL5のインジケーター関連処理は、インジケーターを作る側と、EAからインジケーターを読む側で確認する関数が変わります。

EA連携の基本フロー

EAからインジケーター値を使う場合は、iCustomでハンドルを作成し、BarsCalculatedで計算状態を確認し、CopyBufferで値を取得し、終了時にIndicatorReleaseでハンドルを解放する流れで考えると整理しやすくなります。

iCustom

iCustomは、EAや別のプログラムからカスタムインジケーターを呼び出し、インジケーターハンドルを作成するための関数です。

iCustomで作成したハンドルが無効なままCopyBufferを行うと、値取得に失敗します。EA連携では、iCustomの戻り値がINVALID_HANDLEではないことを必ず確認します。

iCustomで確認すること

CopyBuffer

CopyBufferは、インジケーターバッファから値を取得するための関数です。EAがインジケーターのサインや数値を使う場合、CopyBufferの戻り値と取得した配列の中身を確認します。

CopyBufferで取得した値が0だからといって、必ずしもサインなしとは限りません。インジケーター側の仕様により、0が有効値、EMPTY_VALUEが空値、価格値がサイン位置、1や-1が方向フラグなど、意味が異なります。

CopyBufferで確認すること

BarsCalculated

BarsCalculatedは、インジケーターが何本分計算済みかを確認するために使います。CopyBufferの前に計算状態を確認することで、初回ロード中や履歴不足による取得失敗を切り分けやすくなります。

IndicatorRelease

IndicatorReleaseは、作成したインジケーターハンドルを解放するための関数です。EA終了時やインジケーター再作成時には、不要なハンドルを解放する設計にします。

長時間稼働EAや複数インジケーターを使うEAでは、ハンドル管理を曖昧にすると、再初期化や時間足変更時に不具合を追いにくくなります。

SetIndexBuffer

SetIndexBufferは、カスタムインジケーターのバッファ配列をインジケーターの出力バッファとして割り当てるための関数です。

インジケーターをEAから読み取る前提にする場合、どのbuffer indexにBUYサイン、SELLサイン、補助値、ライン値を出すかを明確にすることが重要です。

SetIndexBufferで整理すること

OnCalculate

OnCalculateは、カスタムインジケーターの計算処理を行うイベント関数です。インジケーター作成では、rates_total、prev_calculated、time、open、high、low、closeなどを使って、必要な本数だけ計算します。

OnCalculate内の計算開始位置や配列参照を誤ると、サインがずれる、過去値が消える、リペイントのように見える、配列範囲外になる、といった問題が起きやすくなります。

OnCalculateで確認すること

PlotIndexSetInteger / PlotIndexSetDouble

PlotIndexSetIntegerやPlotIndexSetDoubleは、インジケーターの描画設定を行う関数です。矢印、線、色、描画開始位置、空値などの設定に関係します。

描画設定で注意すること

ArraySetAsSeries

ArraySetAsSeriesは、配列を時系列配列として扱うかどうかを設定する関数です。時系列配列では、index 0 が最新バーとして扱われる場面が多くなります。

CopyBufferやCopyRates、OnCalculate内の配列参照では、配列の向きを混同すると、現在足と過去足の参照がずれます。

indicator handle

indicator handleは、インジケーターを識別するためのハンドルです。iCustomやiMA、iATR、iRSIなどの関数で作成し、CopyBufferで値を取得する時に使います。

buffer index

buffer indexは、インジケーターバッファの番号です。CopyBufferでどのバッファを読み取るかを指定します。

EA連携で最も多い確認ミスのひとつが、BUYサインとSELLサインのbuffer index違いです。インジケーター作成者側とEA作成者側で、buffer番号と値の意味を明確に共有する必要があります。

shift

shiftは、どのバーの値を見るかを示す考え方です。EA連携では、現在足の値を見るのか、1本前の確定足を見るのかを明確にします。

確認ポイント：EA化を前提にする場合は、shift=0で現在足サインを読むのか、shift=1で確定足サインを読むのかを必ず決めてください。現在足の値は、足確定前に変化する場合があります。

リペイント確認との関係

リペイントとは、過去に表示されたサインや値が、後から変化・消失・移動する挙動を指すことがあります。すべての再計算が問題というわけではありませんが、EA連携や検証では、サインがいつ確定するのかを明確にする必要があります。

EA利用者向けの確認ポイント

EAがインジケーターのサインを使っている場合、チャートに矢印が見えていることと、EAがそのサインを読み取れていることは別です。

MQL5開発者向けの実装確認ポイント

MQL5開発では、インジケーター作成側とEA連携側を分けて設計することが重要です。表示系と判定系、現在足と確定足、buffer値と描画表示を混同しないようにします。

実装時の注意点

• iCustomの戻り値がINVALID_HANDLEではないか確認する
• CopyBuffer前にBarsCalculatedを確認する
• CopyBufferの戻り値が期待本数以上か確認する
• buffer indexの意味を仕様書に残す
• BUYサイン、SELLサイン、補助値のバッファを分ける
• EMPTY_VALUE、0、価格値、フラグ値の意味を混同しない
• shift=0とshift=1の違いを明確にする
• 現在足サインと確定足サインを分ける
• 表示される矢印とEAが読む値を同一視しない
• IndicatorReleaseでハンドル解放を行う

インジケーター関数・用語の辞典表

開発依頼前に整理する情報

インジケーター開発やEA連携まわりの不具合調査・改修依頼を行う場合は、次の情報を整理してください。

送ってはいけない情報：口座パスワード、投資家パスワード、Webhook URL、GAS URL、APIキー、認証トークン、口座番号の全桁、個人情報は、そのまま送らないでください。必要に応じて必ずマスクしてください。

関連するMQL5技術辞典

インジケーター関数の確認では、関数全体、エラーコード、時系列取得、ファイル操作、チャート表示、列挙型、標準ライブラリの理解も関係します。関連するMQL5技術辞典もあわせて確認してください。

確認ポイント：インジケーター連携では、iCustomのhandle、BarsCalculated、CopyBuffer戻り値、buffer index、shift、EMPTY_VALUE、現在足・確定足の扱いをセットで確認してください。

関連する技術講座

FAQ

iCustomで何を確認すればよいですか？

インジケーター名、配置先、Inputs順序、対象symbol、timeframe、handleがINVALID_HANDLEではないかを確認してください。失敗時はGetLastErrorとExpertsログも確認します。

CopyBufferが失敗する場合は何を確認しますか？

handleが有効か、BarsCalculatedが十分か、buffer indexが正しいか、必要本数を取得できているか、GetLastErrorが何かを確認します。現在足と確定足の扱いも確認してください。

buffer indexとは何ですか？

インジケーターバッファの番号です。CopyBufferでどの値を読むかを指定します。BUYサイン、SELLサイン、ライン値、補助値で番号が違うため、仕様書やログで確認する必要があります。

shift=0とshift=1は何が違いますか？

shift=0は現在形成中の足、shift=1は1本前の確定足として扱う場面が多いです。現在足は値が変化する可能性があるため、EA連携ではどちらを使うか明確にしてください。

チャートに矢印が出ていればEAもサインを読めていますか？

必ずしもそうではありません。チャート表示とCopyBufferで取得する値は別に確認してください。表示用bufferとEA判定用bufferが異なる場合もあります。

リペイントしないかどうかはどう確認しますか？

現在足で値が変わるのか、確定足で固定されるのか、過去バー再計算があるのか、サイン発生時のbuffer値をログに残して確認します。用途に応じて、現在足サインと確定足サインを分けてください。

SetIndexBufferはEA利用者にも関係ありますか？

EA利用者が直接触ることは少ないですが、EAがどのbufferを読んでいるかには関係します。EA連携の不具合では、SetIndexBuffer側の割り当てとCopyBuffer側のbuffer indexが一致しているか確認します。

IndicatorReleaseは必ず必要ですか？

EAでインジケーターハンドルを作成した場合、終了時や再初期化時にIndicatorReleaseで解放する設計が安全です。長時間稼働や複数ハンドル利用では特に確認してください。

EA化を依頼する前に何を整理すればよいですか？

インジケーター名、バージョン、Inputs設定、BUY/SELLのbuffer index、サイン値、EMPTY_VALUE、shift、現在足/確定足、リペイント有無、Expertsログ、スクリーンショット、再現手順を整理してください。

この記事にない項目はどのように確認すればよいですか？

まず公式リファレンス、MetaEditorのコンパイル結果、Expertsログ、Journalログ、実際のチャート表示を確認してください。EA連携が関係する場合は、iCustom、CopyBuffer、buffer index、shift、サイン値を整理して確認します。

まとめ

MQL5のインジケーター関数では、インジケーター作成側のOnCalculate、SetIndexBuffer、PlotIndexSet系と、EA連携側のiCustom、BarsCalculated、CopyBuffer、IndicatorReleaseを分けて理解することが重要です。

EAからインジケーター値を読む場合は、iCustomのhandle、CopyBufferの戻り値、buffer index、shift、EMPTY_VALUE、現在足・確定足の扱いをセットで確認してください。

リペイント確認では、現在足サイン、確定足サイン、過去バー再計算、buffer値の固定、ログ記録を分けて確認します。チャートに見えているサインとEA内部で読んでいる値が一致しているかも確認が必要です。

不具合調査や開発依頼を行う場合は、EA名、インジケーター名、バージョン、銘柄、時間足、setファイル、buffer仕様、shift、Expertsログ、Journalログ、スクリーンショット、再現手順を整理してください。