この記事を開いてくださったこと、心から感謝しています。チャートに載っている指標を、プログラムから調べたいと考えている人も多いはずです。
結論から言うと、指標の短縮名を取り出したいならChartIndicatorName、載っている数を知りたいならChartIndicatorsTotalです。ただし、この2つは競合するというより、組み合わせて使う関数です。
また、範囲外の番号を渡したときの動きや、失敗したときの戻り値など、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartIndicatorNameとChartIndicatorsTotalは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つは名前を返し、もう1つは数を返します。
ChartIndicatorNameは、指標の短縮名を返す
ChartIndicatorNameは、指定したチャートのウィンドウにある、指標の短縮名を返す関数です。戻り値はstring型で、引数はチャートID、サブウィンドウ番号、指標の番号の3つです。
返される短縮名は、IndicatorSetString関数でINDICATOR_SHORTNAMEに設定した値だと書かれています。番号は0から数え、最初の指標が0番です。
- 指標の短縮名をstring型で返す
- 引数は、チャートID・サブウィンドウ番号・番号の3つ
- 番号は0から数える
ChartIndicatorsTotalは、指標の数を返す
ChartIndicatorsTotalは、指定したチャートのウィンドウに載っている、指標の数を返す関数です。戻り値はint型で、引数はチャートIDとサブウィンドウ番号の2つです。
公式の説明では、この関数を使うと、チャートに付けられたすべての指標を順に調べていける、と書かれています。番号の範囲を知るための関数です。
- 指標の数をint型で返す
- 引数は、チャートIDとサブウィンドウ番号の2つ
- すべての指標を調べる出発点になる
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartIndicatorName | ChartIndicatorsTotal |
|---|---|---|
| 返すもの | 指標の短縮名 | 指標の数 |
| 戻り値の型 | string | int |
| 引数の数 | 3つ | 2つ |
| 引数の初期値 | 記載なし | 記載なし |
| 失敗時の戻り値 | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
引数の0は、何を意味するのか?
2つの関数の引数には、0が特別な意味を持つものがあります。公式ページの説明を、ここで確認しておきましょう。
チャートIDの0は、現在のチャート
公式の説明では、チャートIDの0は、現在のチャートを示します。ほかのチャート関数と同じ考え方なので、覚えやすい部分です。
- チャートIDの0は、現在のチャート
- ほかのチャート関数と同じ考え方
サブウィンドウ番号の0は、メインウィンドウ
サブウィンドウ番号の0は、メインのチャートウィンドウを示します。ローソク足が表示される部分で、移動平均線などの指標がよく載る場所です。
オシレーター系の指標は、別のサブウィンドウに表示されることが多く、その番号は1以降になります。番号とウィンドウの対応は、サンプルの出力例からも読み取れます。
| 引数 | 0の意味 | 1以降の意味 |
|---|---|---|
| チャートID | 現在のチャート | 個別のチャートID |
| サブウィンドウ番号 | メインウィンドウ | サブウィンドウ |
| 指標の番号(Name) | 最初の指標 | 2番目以降の指標 |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
短縮名とは、どんな名前なのか?
ChartIndicatorNameが返すのは、ファイル名ではなく、短縮名です。この違いは、公式ページでも注意が書かれている大切な部分です。
ファイル名とは、別のものとして扱う
公式の注意書きでは、短縮名は、iCustom関数やIndicatorCreate関数に渡すファイル名とは別のものだと説明されています。混同しないように、との意味です。
短縮名が設定されていない場合は、コンパイル時にソースのファイル名が指定される、とも書かれています。名前を決めていない指標では、ファイル名が返る場合があると読み取れます。
- 短縮名は、ファイル名とは別のもの
- 設定がないと、コンパイル時にファイル名が入る
- 混同しないように、公式にも注意書きがある
パラメーターを含めた名前が、すすめられている
公式の説明では、短縮名は、指標のすべての入力パラメーターの値を含めるのがよい、と書かれています。ChartIndicatorDeleteが、短縮名で指標を見分けるためです。
削除の仕組みについては、ChartIndicatorAddとChartIndicatorDeleteの記事で整理しています。名前の付け方は、削除のしやすさにも関わる点です。
| 名前の例(公式サンプルの出力) | 読み取れること |
|---|---|
| AMA(9,2,30) | 指標名と3つのパラメーターが入っている |
| SAR(0.02,0.20) | 指標名と2つのパラメーターが入っている |
| Fractals | 括弧がなく、パラメーターは見当たらない |
※公式サンプルの出力例を、筆者が整理しました。名前の決まりまでは、記載なしです。
公式のサンプルは、どう書かれているのか?
2つの公式サンプルは、よく似た作りです。ウィンドウの数を調べ、1つずつのウィンドウについて、指標の数や名前を表示します。
ChartIndicatorsTotalのサンプルは、数を表示する
サンプルは、まずChartIDで現在のチャートのIDを取り、ChartGetIntegerでウィンドウの総数を調べます。そのあと、ウィンドウごとに、指標の数を表示します。
出力例には、チャートIDと、サブウィンドウ0から2までの指標の数が、それぞれ3、2、1と書かれています。ウィンドウの総数の取得は、ChartGetIntegerとChartGetDoubleの記事でも扱った考え方です。
- ChartIDで、現在のチャートのIDを取る
- ChartGetIntegerで、ウィンドウの総数を調べる
- ウィンドウごとに、指標の数を表示する
ChartIndicatorNameのサンプルは、名前を並べる
こちらのサンプルも、ウィンドウの総数を調べるところまでは同じです。続いて、ウィンドウごとにChartIndicatorsTotalで数を取り、その数だけ繰り返して、名前を取り出します。
取り出した名前は、1つの文字列につなげて、まとめて表示されます。出力例では、ウィンドウ0にAMAとSARとFractals、ウィンドウ1にRSIとAMA、ウィンドウ2にMFIが並びます。
- ChartIndicatorsTotalで、数を先に取る
- その数だけ繰り返して、名前を取り出す
- 名前をつなげて、ウィンドウごとに表示する
2つのサンプルを、表で比べる
| 項目 | ChartIndicatorsTotal | ChartIndicatorName |
|---|---|---|
| 表示するもの | 指標の数 | 指標の短縮名 |
| 繰り返し | ウィンドウごと | ウィンドウごと、指標ごと |
| もう一方の関数 | 使わない | ChartIndicatorsTotalを使う |
| エラーの確認 | していない | していない |
※公式サンプルの内容を、筆者が整理しました。
失敗したときや範囲外のときは、どうなるのか?
ここは、公式ページの記載が少なく、慎重に読む必要がある部分です。分かる範囲と、記載なしの範囲を分けて整理します。
分かるのは、GetLastErrorで調べられること
2つの関数とも、エラーの詳細を知りたいときは、GetLastError関数を使うと書かれています。ただし、具体的なエラーコードの一覧は、ページには記載なしでした。
- エラーの詳細は、GetLastErrorで調べる
- エラーコードの一覧は記載なし
記載なしの点は、自分で確かめる
失敗したときの戻り値や、範囲外の番号を渡したときの動きは、どちらのページにも記載なしでした。そのため、サンプルのように、番号は数の範囲内で使うのが安全です。
また、指標の並び順が、付けた順なのかどうかも、記載なしです。番号は0から始まる、という点だけが確認できる内容でした。
| 確認できること | 確認できないこと |
|---|---|
| 番号は0から数える | 指標の並び順 |
| 数はChartIndicatorsTotalで取れる | 失敗時の戻り値 |
| エラーはGetLastErrorで調べる | 範囲外の番号の動き |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
どう使い分ければよいのか?
2つは、どちらか一方を選ぶというより、役割を分けて使う関数です。数を先に取り、その数の範囲で名前を取り出す、という流れが公式サンプルの形です。
数だけ知りたいなら、ChartIndicatorsTotalを選ぶ
指標が載っているかどうかや、いくつ載っているかだけを知りたいときは、ChartIndicatorsTotalだけで足ります。名前を取り出す手間がなく、手軽に確認できます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
名前を知りたいなら、ChartIndicatorNameを選ぶ
どの指標が載っているかを知りたいときや、削除する対象を確かめたいときは、ChartIndicatorNameが向いています。短縮名で見分けられる点が特長です。
- 載っている指標の名前を知りたい
- 削除する対象を、名前で確かめたい
- パラメーターを含む名前で見分けたい
全部を調べるなら、2つを組み合わせる
チャート上のすべての指標を一覧にしたいときは、ChartIndicatorsTotalで数を取り、その数だけChartIndicatorNameを呼びます。公式サンプルも、この流れで作られています。









もう1つのコツは、繰り返しの回数に、取得した数をそのまま使うことです。決め打ちの数を書かないので、指標が増減しても、範囲外の番号を渡しにくくなります。
- 繰り返しの回数に、取得した数を使う
- 結果は、まずログに出して確かめる
- 番号が範囲内かを、常に意識する
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
指標の番号は、1から始まるのか?
いいえ。公式の説明では、番号は0から始まり、リストの最初の指標が0番です。数が3なら、使える番号は0から2までになります。
- 番号は0から始まる
- 数が3なら、番号は0から2
短縮名は、自分で決められるのか?
公式の説明では、短縮名はIndicatorSetString関数で設定すると書かれています。設定がない場合は、コンパイル時にファイル名が入る、との説明です。
- IndicatorSetStringで設定する
- 設定がないとファイル名が入る
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの出力例と、筆者が整理した内容です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの出力例をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartIndicatorNameとChartIndicatorsTotal、載っている指標の短縮名を1つずつ取り出せる詳しさと数を先に数えられる確実さどっちを選ぶ?」
指標の短縮名を取り出したいならChartIndicatorName、載っている数を知りたいならChartIndicatorsTotalです。全部を調べるときは2つを組み合わせ、記載のない点は自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










