この記事を開いてくださったこと、心から感謝しています。チャートのIDを調べたり、通貨ペアや時間足をプログラムから切り替えたりしたいと考えている人も多いはずです。
結論から言うと、今のチャートのIDが欲しいならChartID、通貨ペアや時間足を切り替えたいならChartSetSymbolPeriodです。ただし、この2つは役割が違い、組み合わせて使う場面が多い関数です。
また、再初期化のあとに状態が残るかどうかなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartIDとChartSetSymbolPeriodは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つはIDを調べる関数で、もう1つはチャートを切り替える関数です。
ChartIDは、現在のチャートのIDを返す
ChartIDは、現在のチャートのIDを返す関数です。戻り値はlong型で、引数はありません。呼び出すだけで、プログラムが動いているチャートのIDが受け取れます。
公式ページには、注意書きや、エラー処理に関する説明がありません。失敗したときの戻り値も、確認したページには記載なしでした。
- 現在のチャートのIDを返す
- 戻り値はlong型
- 引数はない
ChartSetSymbolPeriodは、通貨ペアと時間足を切り替える
ChartSetSymbolPeriodは、指定したチャートの通貨ペアと時間足を、まとめて変更する関数です。戻り値はbool型で、引数はチャートID、通貨ペア、時間足の3つです。
通貨ペアにNULLを渡すと現在のチャートの通貨ペア、時間足に0を渡すと現在の時間足を意味する、と書かれています。チャートIDの0は、現在のチャートです。
- 通貨ペアと時間足をまとめて変更する
- 戻り値はbool型
- 引数は、チャートID・通貨ペア・時間足の3つ
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartID | ChartSetSymbolPeriod |
|---|---|---|
| 役割 | 現在のチャートのIDを返す | 通貨ペアと時間足を変更する |
| 戻り値の型 | long | bool |
| 引数 | なし | チャートID・通貨ペア・時間足 |
| 失敗時の扱い | 記載なし | falseを返し、GetLastErrorで調べる |
| 動き方 | 呼ぶとすぐ値が返る | 非同期(命令を送るだけ) |
※公式の説明をもとにした、筆者の整理です。
ChartIDは、どんな場面で使うのか?
ChartIDは、とても短い関数ですが、ほかのチャート関数の引数に渡すIDを得る入口になります。ここでは、公式ページの内容を整理します。
ほかの関数に渡すIDを、受け取れる
チャート関連の関数の多くは、最初の引数にチャートIDを取ります。ChartIDで受け取った値を渡すと、プログラムが動いているチャートを明示して操作できます。
ただし、チャートIDの0は、現在のチャートを意味する、という決まりもあります。そのため、現在のチャートが対象なら、IDを取らずに0を渡す書き方もできます。
- ほかのチャート関数に渡すIDを受け取れる
- IDの0でも、現在のチャートを指せる
- IDを変数に入れると、どのチャートか分かりやすい
公式サンプルは、ChartIDを呼んでいない
公式サンプルは、ChartFirstとChartNextを使って、開いているチャートのIDと通貨ペアを一覧で表示します。ところが、確認したコードの中には、ChartIDの呼び出しがありません。
この一覧の作り方は、ChartFirstとChartNextの記事で整理しています。通貨ペア名は、ChartSymbol関数で取り出しています。
出力例には、チャートごとに、番号とIDと通貨ペアが並びます。IDの数字は、環境ごとに変わる例の値で、同じ数字が出るとは限りません。
| サンプルで使う関数 | 役割 |
|---|---|
| ChartFirst | 最初のチャートのIDを取る |
| ChartNext | 次のチャートのIDを取る |
| ChartSymbol | チャートの通貨ペア名を取る |
※公式サンプルの内容を、筆者が整理しました。
ChartSetSymbolPeriodは、どう動くのか?
ChartSetSymbolPeriodは、チャートの見た目だけでなく、動いているプログラムにも影響します。公式の注意書きを、順に確認しましょう。
非同期で動き、trueは「受け付けた」だけ
公式の説明では、この関数は非同期です。命令を送るだけで、実行の完了は待たず、命令はチャートのキューに追加されて、前の命令の処理が終わってから実行されます。
戻り値のtrueは、命令がキューに追加されたことを示します。変更が終わったことまでは意味しません。falseのときは、GetLastErrorで詳細を調べると書かれています。
- 命令を送るだけで、完了は待たない
- trueは、キューに追加された意味
- falseのときはGetLastErrorで調べる
切り替えると、エキスパートアドバイザーが再初期化される
公式の注意書きには、通貨ペアや時間足を変えると、チャートに付いているエキスパートアドバイザーが再初期化される、と書かれています。切り替えは、動いているプログラムに影響するということです。
ただし、再初期化のあとに、入力値やグローバル変数の状態が残るかどうかは、確認したページには記載なしでした。使う前に、自分の環境で確かめておくのが安全です。
- 切り替えると、再初期化される
- 状態が残るかどうかは記載なし
- 使う前に、動きを確かめておく
同じ組み合わせを指定すると、更新の代わりになる
同じ通貨ペアと同じ時間足を指定して呼び出すと、チャートの更新に使える、と書かれています。ターミナルの更新コマンドに似た動きで、付いている指標の再計算も起こります。
公式ページでは、週末のようにティックが来ない時間帯でも、指標を計算できる点が例に挙がっています。ただし、細かい動きは記載なしでした。
| 注意点 | 公式の記載 |
|---|---|
| 非同期で動く | あり |
| エキスパートアドバイザーが再初期化される | あり |
| 同じ組み合わせで更新に使える | あり |
| 再初期化のあとの状態 | 記載なし |
| 無効な通貨ペアを渡したときの動き | falseを返す以外は記載なし |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
公式のサンプルは、どう書かれているのか?
ChartSetSymbolPeriodの公式サンプルは、現在のチャートを、別の通貨ペアと時間足に切り替える短いコードです。ここでChartIDも、実際に使われています。
ChartIDで取ったIDを渡して、切り替える
サンプルは、まず、GBPUSDとPERIOD_H1を、定数として決めておきます。続いて、ChartIDで現在のチャートのIDを取り、SymbolとPeriodで、現在の通貨ペアと時間足も取ります。
そのあと、変更前の内容を表示してから、ChartSetSymbolPeriodを呼び出します。ChartIDが、ほかの関数の入口になる、わかりやすい例です。
- 切り替え先を、定数で決めておく
- ChartIDで、現在のチャートのIDを取る
- 変更前の内容を表示してから、切り替える
出力例は、EURUSDのM1からGBPUSDのH1
出力例は、EURUSDの1分足のチャートを、GBPUSDの1時間足に変える内容になっています。時間足の名前は、EnumToStringで取った文字列の、先頭7文字を取り除いて短くしています。
なお、このサンプルは、戻り値の確認をしていません。実際に使うときは、falseのときにGetLastErrorで調べる形にしたほうが、原因を追いやすくなります。
| 項目 | サンプルの内容 |
|---|---|
| 切り替え前 | EURUSDの1分足(M1) |
| 切り替え後 | GBPUSDの1時間足(H1) |
| 戻り値の確認 | していない |
| IDの取得 | ChartIDを使う |
※公式サンプルの内容を、筆者が整理しました。
どう使い分ければよいのか?
2つは競合する関数ではなく、IDを知る関数と、チャートを変える関数です。そのため、片方を選ぶというより、目的に合わせて使い分けます。
IDだけ欲しいなら、ChartIDを選ぶ
プログラムが動いているチャートのIDを、変数に入れて使いたいときは、ChartIDが向いています。引数がなく、呼ぶだけで済むのが特長です。
FX口座・ツールの比較一覧もあわせて確認してみてください。
切り替えたいなら、ChartSetSymbolPeriodを選ぶ
通貨ペアと時間足を、プログラムから変えたいときは、ChartSetSymbolPeriodが向いています。通貨ペアと時間足を、まとめて指定できるのが特長です。
通貨ペアと時間足を、あとから確かめたいときは、ChartSymbolとChartPeriodの記事も参考になります。
- 通貨ペアと時間足を、まとめて変えたい
- 同じ組み合わせで、チャートを更新したい
- 非同期で動くことを、理解して使う
組み合わせるなら、IDを先に取る
公式サンプルのように、ChartIDでIDを取ってから、ChartSetSymbolPeriodに渡す形が、基本の流れです。現在のチャートなら、0でも同じ意味になります。









もう1つのコツは、切り替えの結果を確かめるときに、命令の完了を待たずに次の処理へ進まないことです。非同期の関数なので、反映を前提にした処理は、慎重に組み立てましょう。
- 切り替えは、非同期だと意識する
- falseのときは、GetLastErrorで調べる
- 結果は、まずログに出して確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ChartIDの代わりに、0を渡してもよいのか?
公式の説明では、チャートIDの0は、現在のチャートを意味します。そのため、現在のチャートが対象なら、0を渡す書き方でも同じ意味になります。
- 0は、現在のチャート
- IDを明示したいときは、ChartIDを使う
切り替えたあと、すぐに値は変わるのか?
公式の説明では、この関数は非同期で、命令は前の命令の処理が終わってから実行されます。そのため、呼び出した直後に変わっているとは限りません。
- 非同期で動く
- 呼び出した直後の反映は保証されない
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの出力例と、筆者が整理した内容です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの出力例をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartIDとChartSetSymbolPeriod、今のチャートのIDをすぐ受け取れる手軽さと通貨ペアや時間足をまとめて切り替えられる便利さどっちを選ぶ?」
今のチャートのIDが欲しいならChartID、通貨ペアや時間足を切り替えたいならChartSetSymbolPeriodです。切り替えは非同期で、再初期化も起こるため、記載のない点は自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










