この記事を開いてくださったこと、心から感謝しています。MQL5で銘柄の一覧を作りたいとき、どこまでの銘柄を対象にするかで迷った人も多いはずです。
結論から言うと、今表示している銘柄だけで足りるならtrue、サーバーにある全銘柄から探したいならfalseを使う、という考え方が基本です。
ただし、銘柄の並び順や、リストが途中で変わったときの動きは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの調べ方の仕組み・前提・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
SymbolsTotalのtrueとfalseは、そもそも何が違うのか?
まずは、公式リファレンスで説明されている、2つの調べ方の基本的な性格を整理します。
trueは、マーケットウォッチの銘柄だけを数える
MQL5公式リファレンスによると、SymbolsTotalは、利用できる銘柄の数を返す関数です。引数のselectedにtrueを渡すと、マーケットウォッチで選ばれている銘柄の数が返ります。
銘柄の名前は、SymbolNameで取り出します。位置を表す番号と、同じtrueまたはfalseを渡します。trueなら、マーケットウォッチの中の銘柄だけが対象になります。
- SymbolsTotal(true)で数を調べる
- SymbolName(番号, true)で名前を取る
- 対象は表示中の銘柄だけ
falseは、サーバーにある全銘柄を数える
selectedにfalseを渡すと、サーバーにある全銘柄の数が返ります。SymbolNameにもfalseを渡せば、全銘柄の一覧から名前を取り出せます。
公式のサンプルでは、全銘柄の数と、マーケットウォッチの銘柄の数を、両方出力しています。コメントには、全銘柄が140、選択中が11という例が載っています。ただし、これは説明用の数字です。
- SymbolsTotal(false)で全銘柄の数
- SymbolName(番号, false)で全銘柄の名前
- サンプルの数字は例にすぎない
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | true | false |
|---|---|---|
| 対象 | マーケットウォッチの銘柄 | サーバーの全銘柄 |
| 数の関数 | SymbolsTotal(true) | SymbolsTotal(false) |
| 名前の関数 | SymbolName(番号, true) | SymbolName(番号, false) |
| 並び順 | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
マーケットウォッチの銘柄だけを調べると、どうなるのか?
次に、表示中の銘柄だけを対象にする1つ目の方法を見ていきます。
SymbolSelectで、対象を増やしたり減らしたりできる
公式ページによると、SymbolSelectは、銘柄をマーケットウォッチに加えたり、外したりする関数です。第1引数に銘柄名、第2引数にtrueかfalseを渡します。失敗するとfalseが返ります。
外すときには、注意書きがあります。その銘柄のチャートが開いているときや、その銘柄の建玉があるときは、外せない、と書かれています。
- trueで加え、falseで外す
- 失敗するとfalseが返る
- チャートや建玉があると外せない
公式サンプルは、加えて、位置を調べ、外している
SymbolSelectのサンプルでは、まず銘柄が存在するかを確かめます。次に、マーケットウォッチへ加え、失敗したらGetLastErrorで理由を出力します。
成功したら、補助の関数で、マーケットウォッチの中での位置を探します。サンプルの出力例では、加えた直後は12、外したあとは-1になっています。
| サンプルの手順 | 内容 |
|---|---|
| 1 | 銘柄の存在を確認 |
| 2 | trueで加える |
| 3 | 位置を探して出力 |
| 4 | falseで外して、再び探す |
※公式の説明から読み取れる内容を、筆者が整理しました。
順番や途中の変化は、確認できなかった
マーケットウォッチの中での銘柄の並び順は、確認したページに記載なしでした。位置を表す番号が、あとから変わらないのかも、記載なしです。
ループの途中で銘柄を外したとき、数や名前がどう変わるのかも、記載なしでした。そのため、ループの中で増減させる場合は、自分の環境で動きを確かめる必要があります。
サーバーの全銘柄を調べると、どうなるのか?
続いて、全銘柄を対象にする2つ目の方法を見ていきます。
探したい銘柄が、表示中にないときに使える
公式のSymbolNameのサンプルでは、全銘柄の一覧を、最初から最後まで順に見ています。目的の銘柄名と同じものを探し、見つかったら名前と位置を出力して、ループを抜けます。
見つからなかったときは、サーバーにはなかった、という内容の文を出力します。表示中にない銘柄でも、サーバーにあるかどうかを調べられます。
- 全銘柄を順に見られる
- 見つかったら位置を出力する
- 見つからなければその旨を出力する
表示されない銘柄も、自動で選ばれることがある
銘柄プロパティのページには、SYMBOL_VISIBLEという項目があります。これは、マーケットウォッチに見えているかどうかを表します。SYMBOL_SELECTは、選ばれているかどうかを表します。
証拠金や損益の計算に必要な、通貨の組み合わせの銘柄は、自動で選ばれても、画面には表示されないことがある、と説明されています。表示させるには、自分で選ぶ必要があります。
| プロパティ | 公式の説明 |
|---|---|
| SYMBOL_SELECT | マーケットウォッチで選ばれている |
| SYMBOL_VISIBLE | マーケットウォッチに見えている |
| SYMBOL_EXIST | その名前の銘柄がある |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
全銘柄を回すときの手間や速さは、確認できなかった
全銘柄を順に調べるのに、どのくらい時間がかかるのかは、確認したページに記載なしでした。銘柄の数の上限や、マーケットウォッチの大きさの上限も、記載なしです。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの使い方を比べます。
例の前提を、そろえる
EAが、複数の銘柄を順に確認したい場合を考えます。1つは、いま表示している銘柄だけを確認したい場合です。もう1つは、名前の一部が合う銘柄を、サーバー全体から探したい場合です。
- 表示中の銘柄だけを確認したい
- 全体から名前で探したい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
表示中だけなら、trueで十分
自分が選んだ銘柄だけを順に処理するなら、trueで足ります。対象が少なくなるので、ループの回数も、自分の管理している範囲に収まります。
ただし、実際にどのくらい軽くなるのかは、公式に記載がありません。仮の例として、考え方だけを参考にしてください。
- 自分で選んだ銘柄だけを処理できる
- 対象の範囲を自分で管理しやすい
- 速さの違いは自分で確かめる
全体から探すなら、falseを使う
名前の一部で探したい場合や、サーバーにある銘柄を確かめたい場合は、falseが向いています。見つけた銘柄を使うときは、SymbolSelectで加えてから使う流れが考えられます。
ただし、加えられる数に上限があるのかは、公式に記載がありません。多くの銘柄を加えるときは、動きを確かめながら進めると安心です。
| 流れ(仮) | true | false |
|---|---|---|
| 表示中の銘柄の処理 | 向いている | 対象が広すぎる |
| 名前で全体から探す | 対象外の銘柄は見つからない | 向いている |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
表示中の銘柄だけでよいなら、trueを選ぶ
自分で選んだ銘柄だけを処理するなら、trueが向いています。売買の価格を一度に取る方法は、SymbolInfoTickとSymbolInfoDoubleの比較記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
全体から探したいなら、falseを選ぶ
サーバーにある銘柄から探したいなら、falseが向いています。発注前の必要証拠金を調べる方法は、OrderCalcMarginと銘柄情報の比較記事で整理しています。
- 全体から名前で探したい
- サーバーにあるかを確かめたい
- 見つけたらSymbolSelectで加える
小さく試して、動きを確かめる
いきなり本番のEAで使わず、小さなスクリプトで、2つの数と名前を並べて出力してみましょう。銘柄を加えたり外したりしたときに、数がどう変わるのかも、見ておくと安心です。









もう1つのコツは、位置の番号を長く持ち続けず、必要なときに名前で探し直すことです。番号が変わらないかは記載なしなので、名前のほうが安心して使えます。
また、SymbolSelectが失敗したときは、戻り値のfalseだけで終わらせず、GetLastErrorで理由を出力しておくと、あとで原因を追いやすくなります。
- 2つの数と名前を並べて出力する
- 加えたり外したりして数の変化を見る
- 番号より名前で確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
マーケットウォッチにない銘柄の情報は、読めるのか?
SymbolInfoIntegerのページには、マーケットウォッチで選ばれていない銘柄では、エラー4302が返る場合がある、と書かれています。そのため、読む前にSymbolSelectで加える流れが考えられます。
- 選ばれていない銘柄はエラー4302
- 読む前にSymbolSelectで加える
銘柄が存在するかは、どう調べるのか?
銘柄プロパティには、SYMBOL_EXISTという項目があります。その名前の銘柄があるかどうかを、真偽で表すと説明されています。公式のサンプルでも、存在確認をしてから加えています。
- SYMBOL_EXISTで存在を確かめる
- サンプルは存在確認から始めている
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のSymbolsTotalとSymbolName、マーケットウォッチの銘柄だけを順に調べる手軽さとサーバーにある全銘柄を順に調べる網羅性どっちを選ぶ?」
表示中の銘柄だけで足りるならtrue、全体から探したいならfalseが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










