この記事を開いてくださったこと、心から感謝しています。端末で開いているチャートを、プログラムから順番に調べたいと考えている人も多いはずです。
結論から言うと、最初のチャートのIDだけが欲しいならChartFirst、次のチャートへ順にたどりたいならChartNextです。2つは対になる関数で、組み合わせて一覧を作ります。
ただし、チャートが並ぶ順番や、チャートが1つもないときの値など、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartFirstとChartNextは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。一言でいえば、出発点を返す関数と、次へ進む関数です。
ChartFirstは、最初のチャートのIDを返す
MQL5公式リファレンスによると、ChartFirstは、端末の最初のチャートのIDを返す関数です。戻り値はlong型で、引数はありません。
公式サンプルのコメントには、端末で最初に開かれたチャートのIDを取得する、と書かれています。ただし、この「最初」の並びを公式が定義しているかどうかは、記載なしでした。
- 最初のチャートのIDを返す
- 戻り値はlong型
- 引数はない
ChartNextは、次のチャートのIDを返す
ChartNextは、引数で渡したチャートの、次のチャートのIDを返す関数です。引数はlong型のチャートIDが1つで、戻り値もlong型です。
リストの終わりに達したときは、-1を返すと書かれています。この-1が、ループを終えるための目印になります。
- 次のチャートのIDを返す
- 引数はチャートIDが1つ
- 終わりに達したら-1を返す
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartFirst | ChartNext |
|---|---|---|
| 役割 | 最初のチャートのID | 次のチャートのID |
| 引数 | なし | チャートID |
| 戻り値 | long型のID | long型のID(終端は-1) |
| サンプルの内容 | 1つ目の情報を表示 | 全チャートを順に表示 |
| 並び順の定義 | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ChartNextの引数は、どう読めばよいのか?
ChartNextには、読み違えやすい注意書きがあります。ここを押さえておくと、思わぬ動きを避けられます。
0は、現在のチャートを意味しない
公式ページには、0は現在のチャートを意味せず、最初のチャートのIDを返す指定になる、と書かれています。ほかのチャート関数では、0が現在のチャートを指すことが多いため、注意が必要です。
現在のチャートの次を知りたいときは、0ではなく、現在のチャートのIDを渡す必要があります。この点は、公式の説明から読み取れる内容です。
- 0は現在のチャートではない
- 0を渡すと最初のチャートのIDが返る
- 現在のチャートの次は、IDを渡して調べる
終端の-1が、唯一の目印になる
戻り値が-1のときは、チャートのリストの終わりに達した合図です。ただし、無効なIDや、すでに閉じたチャートのIDを渡したときの値は、記載なしでした。
| 確認できること | 確認できないこと |
|---|---|
| 終端では-1が返る | 並び順の定義 |
| 0は最初のチャートを返す | 無効なIDを渡したときの値 |
| 引数はlong型のID | チャートが0個のときのChartFirstの値 |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
公式のサンプルは、どう書かれているのか?
2つの公式サンプルは、短いコードです。ChartFirstの1行を、ChartNextで繰り返す形になっています。
ChartFirstのサンプルは、1つ目の情報を表示する
ChartFirstのサンプルは、最初のチャートのIDを受け取り、そのチャートの通貨ペアと時間足を調べて表示します。時間足の名前は、文字列の先頭7文字を除いて短くしています。
コメントの出力例では、EURUSDのM1のチャートが示されています。この例は環境によって変わるため、値の目安として見る程度にしましょう。
- 最初のチャートのIDを受け取る
- 通貨ペアと時間足を調べる
- 時間足名の先頭を除いて表示する
ChartNextのサンプルは、リストの終わりまでたどる
ChartNextのサンプルは、まずChartFirstで最初のチャートを取得し、その情報を表示します。そのあと、ChartNextを繰り返し呼んで、-1が返るまで順に表示します。
ループには、100回までという上限が付いています。コメントには、100を超えるチャートを開いていることはない、と書かれています。ただし、これが端末の公式な上限かどうかは、記載なしです。
このページには、実際の出力例は載っていませんでした。表示の見え方は、記載なしです。
| 手順 | やっていること |
|---|---|
| 1 | ChartFirstで最初のIDを取る |
| 2 | 最初のチャートの情報を表示する |
| 3 | ChartNextで次のIDを取る |
| 4 | -1ならループを抜ける |
| 5 | IDを更新して繰り返す |
※公式のサンプルの流れを、筆者が整理しました。
取得したチャートIDは、ほかの関数でどう使うのか?
2つの関数が返すのは、チャートのIDだけです。通貨ペアや時間足といった中身を知るには、そのIDを、別の関数に渡す必要があります。
公式サンプルでは、ChartSymbolとChartPeriodに渡している
ChartFirstのサンプルでは、受け取ったIDを、ChartSymbolとChartPeriodに渡しています。前者は通貨ペア名を、後者は時間足を返す関数として使われています。
ChartNextのサンプルでは、ChartSymbolだけを使って、通貨ペア名とIDを並べて表示しています。つまり、IDは、中身を調べるための入口という位置づけです。
- IDは、中身を調べる入口になる
- 通貨ペアはChartSymbolで調べる
- 時間足はChartPeriodで調べる
IDを保存して、あとから使い回す
一覧をたどる途中で見つけたIDは、変数や配列に保存しておくと、あとから何度でも使えます。保存の方法や、配列の大きさの決め方は、公式ページには書かれていません。
チャートを開いたり閉じたりすると、一覧の中身も変わります。そのため、保存したIDが、あとで無効になっている可能性があります。この点は、公式ページに記載なしですが、使う側で気をつけたいところです。
| 場面 | 使う関数 |
|---|---|
| 通貨ペアを調べる | ChartSymbol |
| 時間足を調べる | ChartPeriod |
| IDを保存して使い回す | 自分のコードで管理する |
※公式のサンプルの内容を、筆者が整理しました。保存したIDの扱いは、筆者の考察です。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。実際の結果を示すものではありません。
例の前提を、そろえる
端末で開いているすべてのチャートについて、通貨ペアの一覧を作りたい場合を考えます。
- 開いているチャートを、すべて調べたい
- 通貨ペアごとに一覧を作りたい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
1つだけならChartFirst、全部ならChartNext
最初の1つだけで足りるなら、ChartFirstを1回呼ぶだけで済みます。全部を調べたいときは、ChartFirstで始めて、ChartNextで-1が返るまで繰り返します。
- 1つだけなら、ChartFirstだけ
- 全部なら、ChartNextで繰り返す
- 終端は-1で判断する
見つけたチャートへの操作は、別の関数で行う
一覧にしたチャートを開いたり閉じたりしたいときは、ChartOpenとChartCloseの記事が参考になります。IDを手がかりにする点は、共通しています。
| 場面(仮) | 向いている関数 |
|---|---|
| 最初のチャートだけ知る | ChartFirst |
| 全チャートを順にたどる | ChartFirstとChartNext |
| 見つけたチャートを閉じる | ChartClose |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つは競合する関数ではなく、対になる関数です。そのため、どちらかを選ぶというより、目的に応じてどう組み合わせるかを決めることになります。
出発点が欲しいなら、ChartFirstを選ぶ
チャートの一覧をたどる出発点が欲しいときや、最初のチャートだけ分かればよいときは、ChartFirstを使います。引数がなく、1行で呼べます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
順にたどりたいなら、ChartNextを選ぶ
すべてのチャートを調べたいときは、ChartNextを繰り返し呼びます。見つけたチャートにインジケーターを追加したい場合は、ChartIndicatorAddとChartIndicatorDeleteの記事が参考になります。
- すべてのチャートを調べたい
- 終端の-1で止めたい
- 現在のチャートの次を知りたい
小さく試して、動きを確かめる
いきなり複雑な処理を作らず、公式サンプルのように、通貨ペアをログに表示するところから始めましょう。









もう1つのコツは、ループに上限を付けておくことです。公式のサンプルも、100回までという上限を設けています。
- ループに回数の上限を付ける
- -1で終了する処理を必ず入れる
- 順番に依存しない書き方にする
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
チャートの並び順は、決まっているのか?
公式サンプルには、最初に開かれたチャート、というコメントがあります。ただし、並び順の定義や、毎回同じ順になるかどうかは、記載なしです。
- 最初に開かれたチャートというコメントがある
- 並び順の定義は記載なし
チャートが1つもないときは、どうなるのか?
ChartFirstのページには、チャートがないときの戻り値は書かれていません。この場合の動きは、記載なしです。
- チャートが0個のときの値は記載なし
- 使う前に自分の環境で確かめる
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartFirstとChartNext、最初のチャートのIDをすぐ受け取れる手軽さと次のチャートを順にたどれる便利さどっちを選ぶ?」
最初のチャートのIDが欲しいならChartFirst、次のチャートへ順にたどりたいならChartNextです。対にして使い、記載のない点は自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










