この記事を開いてくださったこと、心から感謝しています。MQL5でiMAなどのハンドルを作ったあと、いつ、どこで解放すればよいのか迷った人も多いはずです。
結論から言うと、終了時にまとめて解放したいならOnDeinit、必要な値を取り終えたらすぐ手放したいなら使い終えた直後の解放が向いています。
ただし、ハンドルを1回だけ作るべきか、何度も作ってよいのかは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明と2つの公式の例をもとに、IndicatorReleaseの役割・2つの解放の仕方・仮の流れ・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
IndicatorReleaseは、そもそも何をする関数なのか?
まずは、公式リファレンスでの説明と、ハンドルとの関係を整理します。
ハンドルを消して、メモリを空ける
MQL5公式リファレンスによると、IndicatorReleaseは、インジケーターのハンドルを消し、ほかで使われていなければ、そのインジケーターの計算の部分を解放する関数です。引数はハンドルだけで、成功ならtrue、失敗ならfalseが返ります。
iMAのページにも、使わなくなったインジケーターのメモリは、IndicatorReleaseにハンドルを渡して空けられる、という趣旨の説明があります。
ハンドルとは、作ったインジケーターを指す番号のようなものです。この番号を使って、値を取り出したり、解放したりします。作った番号を、変数に保存しておくのが基本の流れです。
- 引数はインジケーターのハンドル
- 成功ならtrueが返る
- 使わないハンドルのメモリを空ける
ハンドルはすぐ消え、計算の部分は少しあとに消える
公式リファレンスの注意書きによると、ハンドルはすぐに消えますが、計算の部分は、もう呼ばれなければ、しばらくしてから消されます。呼んだ直後に、すべてのメモリが空くわけではありません。
ストラテジーテスターでは、実行されない
公式リファレンスによると、ストラテジーテスターで動かしているときは、IndicatorReleaseは実行されません。テスターで解放の動きを確かめようとしても、期待した結果にならない点に注意しましょう。
たとえば、EAをテスターで動かしたとき、解放の処理が書かれていても、その行は実際には働きません。そのため、解放の書き方は、チャートに載せた実際の動きで見直しましょう。
- テスターでは実行されない
- 解放の確認は別の方法で行う
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
2つの解放の仕方を、表で比べる
公式の例から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | OnDeinitで解放 | 使い終えた直後に解放 |
|---|---|---|
| 公式の例 | iMAのデモ | IndicatorReleaseのテスト |
| ハンドルを作る場所 | OnInit | OnInit |
| 解放する場所 | OnDeinit | OnTickの中 |
| 解放後の扱い | 終了時なので不要 | INVALID_HANDLEに戻す |
※公式の例をもとにした、筆者の整理です。
OnDeinitで解放すると、どうなるのか?
次に、終了時にまとめて解放する、1つ目の方法を見ていきます。
公式のiMAの例は、OnDeinitで解放している
公式リファレンスのiMAの例では、OnInitでハンドルを作り、OnDeinitで、ハンドルが無効でなければIndicatorReleaseを呼んでいます。作った場所と、片付ける場所が分かれていて、読みやすい形です。
OnInitは、EAを動かし始めるときに1回だけ呼ばれる関数です。OnDeinitは、EAを止めるときに呼ばれる関数です。始めと終わりに対応しているため、作成と解放を対にして書きやすくなります。
- OnInitでハンドルを作る
- OnDeinitで解放する
- 無効なハンドルは解放しない
作成に失敗したときは、先に止める
同じ例では、ハンドルがINVALID_HANDLEなら、エラーコードを表示して、初期化の失敗を返しています。そのため、あとの処理が、無効なハンドルで動くことを防げます。
数値の確認は、BarsCalculatedで行う
公式の例では、OnCalculateの中で、BarsCalculatedを使って、計算済みのデータがあるかを確かめています。公式リファレンスによると、BarsCalculatedは、計算済みのデータの数を返し、エラーのときは-1を返します。
この例は、返った値が0以下なら、失敗として処理を終えています。これは例の書き方で、公式が決めたルールとは書かれていません。
- BarsCalculatedで計算済みの数を確かめる
- エラーのときは-1が返る
- 0以下なら処理を終える例
使い終えた直後に解放すると、どうなるのか?
続いて、値を取ったらすぐ手放す、2つ目の方法を見ていきます。
公式のテストの例は、OnTickの中で解放している
公式リファレンスのIndicatorReleaseの例では、OnInitでハンドルを作り、OnTickの中で、直近2本の値を取り出します。値をグローバル変数に保存できたら、その場でハンドルを解放しています。
OnTickは、価格が動くたびに呼ばれる関数です。その中で解放する書き方なので、値を取れたかどうかを確かめてから、解放に進む流れになっています。
- OnInitでハンドルを作る
- 必要な値を取り終えたら解放する
- 解放後はINVALID_HANDLEに戻す
解放したあとは、無効な値に戻しておく
同じ例では、解放に成功したら、ハンドルの変数をINVALID_HANDLEに戻しています。次にOnTickが動いたときに、解放済みのハンドルを、誤って使わないようにするための書き方です。
何度も作ってよいかは、記載なし
確認した3つの公式ページには、ハンドルを1回だけ作るべきか、何度も作ってよいかの説明が、ありませんでした。同じ設定で作ると、1つの計算を共有するのかも、記載がありません。
そのため、解放と作り直しを繰り返す書き方は、実際の動きを確かめてから使いましょう。
作り直しの手間や、処理の重さについても、確認したページに数字や目安の説明は見当たりませんでした。気になる場合は、自分の環境で、動きを見比べてみましょう。
- 作り直しの是非は記載なし
- 同じ設定の共有も記載なし
- 実際の動きを確かめてから使う
仮の流れで比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの方法の流れを比べます。
例の前提を、そろえる
EAを起動してから、チャートから外すまでに、価格が100回動くと仮定します。ハンドルは、起動時に1つだけ作るものとします。
- EAが動く間に価格が100回動く
- ハンドルは起動時に1つ作る
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
OnDeinitなら、100回とも同じハンドルを使える
OnDeinitで解放する場合、起動から終了まで、100回とも同じハンドルで、値を取り出せます。解放は、チャートから外すときの、1回だけです。
- 100回とも同じハンドルを使える
- 解放は終了時の1回だけ
直後に解放すると、使えるのは最初の1回だけになる
公式の例のように、値を取ってすぐ解放すると、そのハンドルが使えるのは、取り出した1回だけです。2回目以降に、また値が必要になるなら、ハンドルを作り直す必要があります。
| 流れ(仮) | OnDeinitで解放 | 直後に解放 |
|---|---|---|
| 1回目の値取得 | ハンドルを使う | ハンドルを使う |
| 2回目以降の値取得 | 同じハンドルを使う | 作り直しが必要 |
| 解放のタイミング | 終了時の1回 | 取得の直後 |
※仮の数字にもとづく、筆者の流れの例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの方法の特徴をふまえて、目的別の使い分けを考えます。
毎回の値が必要なら、OnDeinitが向いている
足が増えるたびに、インジケーターの値を使い続けるEAなら、OnDeinitでまとめて解放する方法が向いています。値の取り出し方は、CopyBufferの位置指定と日時指定の比較記事で整理しています。
また、解放の処理を1か所にまとめておくと、あとからコードを読み返したときに、片付けの漏れに気づきやすくなります。
- 値を毎回使い続けたい
- 作成と解放の場所を分けたい
- 読みやすさを大切にしたい
1回だけの値なら、直後の解放が向いている
起動時の値を1回だけ調べるような使い方なら、取り終えたあとに解放する方法が向いています。処理を動かす頻度の考え方は、OnTickとOnTimerの比較記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
小さく試して、動きを確かめる
いきなり大きなEAで試さず、短いEAで、2つの書き方を並べて試しましょう。ただし、ストラテジーテスターでは解放が実行されないため、チャートに載せて確かめる必要があります。









ログに、ハンドルの値と、解放が成功したかどうかを出しておくと、動きの違いを、あとから落ち着いて見比べられます。
- 短いEAで2つを並べて試す
- テスターではなくチャートで確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
解放を忘れると、どうなるのか?
確認した公式ページには、解放を忘れたときに、具体的に何が起きるかの説明が、ありませんでした。公式は、使わなくなったハンドルは、メモリを空けるために解放できる、と説明しています。
どちらの解放の仕方を選ぶべきか、公式は決めているのか?
確認した公式ページには、どちらを選ぶべきかという推奨の説明は、ありませんでした。公式の2つの例が、それぞれ別の解放の仕方を示している、というだけです。
- 推奨の選び方は記載なし
- 2つの例が別の仕方を示す
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のIndicatorRelease、OnDeinitでまとめて解放する安心感と使い終えた直後に解放して手放す身軽さどっちを選ぶ?」
値を使い続けるならOnDeinitでまとめて解放、1回だけ値が必要なら、取り終えた直後に解放する方法が向いています。どちらでも、解放後のハンドルを使わない書き方を心がけましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










