この記事を開いてくださったこと、心から感謝しています。チャート上に並んだ線やラベルを、プログラムから一覧で扱いたいと考えている人も、きっと多いはずです。
結論から言うと、オブジェクトの数を知りたいならObjectsTotal、順番を指定して名前を取り出したいならObjectNameです。数える関数と、名前を取り出す関数という違いがあり、2つを組み合わせて使うのが基本です。
また、失敗したときの戻り値など、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ObjectsTotalとObjectNameは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つはオブジェクトの数を返す関数で、もう1つは順番を指定して名前を返す関数です。
ObjectsTotalは、オブジェクトの数を数える
ObjectsTotalは、チャート上にあるオブジェクトの数を、整数で返す関数です。引数は、チャートID、サブウィンドウの番号、オブジェクトの種類の3つで、後ろの2つは省略できます。
サブウィンドウの番号を省略すると、-1になり、メインウィンドウを含む、すべてのウィンドウが対象です。0を渡すと、メインウィンドウだけを数えます。
- チャート上のオブジェクトの数を、整数で返す
- 引数は、チャートID・サブウィンドウ・種類
- サブウィンドウの番号の0はメイン、-1はすべて
ObjectNameは、順番を指定して名前を取り出す
ObjectNameは、条件に合うオブジェクトのうち、指定した順番のものの名前を、文字列で返す関数です。引数は、チャートID、順番、サブウィンドウの番号、種類の4つです。
順番は、サブウィンドウの番号と種類で絞り込んだ中での、通し番号です。公式サンプルは0から数えていますが、0からだという明記は、確認したページには記載なしでした。
- 順番を指定して、オブジェクトの名前を返す
- 引数は、チャートID・順番・サブウィンドウ・種類
- 順番は、絞り込んだ中での通し番号
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ObjectsTotal | ObjectName |
|---|---|---|
| 役割 | オブジェクトの数を返す | 順番の名前を返す |
| 戻り値 | int(数) | string(名前) |
| 順番の引数 | なし | あり |
| 同期か非同期か | 同期 | 同期 |
| 失敗時の戻り値 | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ObjectsTotalは、どんな場面で使うのか?
ObjectsTotalは、いま何個のオブジェクトがあるのかを、確かめたいときの関数です。公式の説明から、絞り込み方と注意点を確認します。
サブウィンドウと種類で、絞り込める
サブウィンドウの番号と種類を渡すと、その条件に合うオブジェクトだけを数えられます。種類は、ENUM_OBJECTの値で、-1にするとすべての種類が対象です。
サブウィンドウの数や、指標のウィンドウを探す方法は、ChartWindowFindとChartWindowOnDroppedの記事で整理しています。
- サブウィンドウの番号で、数える範囲を絞れる
- 種類を渡すと、その種類だけを数えられる
- どちらも省略すると、すべてを数える
同期で動くので、重くなることがある
公式の説明では、ObjectsTotalは同期の呼び出しです。そのチャートへ、先に送られている命令がすべて終わるのを待ってから、数を返します。
そのため、オブジェクトが多いチャートでは、時間がかかる可能性があると書かれています。呼び出す回数は、必要な分に絞るのが安心です。
- 先に送られた命令の完了を、待ってから返す
- オブジェクトが多いと、時間がかかることがある
- 呼び出す回数は、必要な分に絞る
失敗したときの値は、記載なし
公式の戻り値の説明は、オブジェクトの数、とだけ書かれています。チャートIDが正しくないときに、何が返るのかは、確認したページには記載なしでした。
| 確認した点 | 公式の記載 |
|---|---|
| 戻り値 | オブジェクトの数 |
| 失敗時の戻り値 | 記載なし |
| エラーコード | 記載なし |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
公式サンプルの出力例は、数の見方の参考になる
公式ページの出力例では、メインウィンドウに656個、番号1と番号2のウィンドウに、それぞれ2個のオブジェクトがある、と書かれています。メインの数には、取引の印も含まれる、という説明です。
この数は、あくまで公式ページの例で、あなたのチャートの数ではありません。自分のチャートで数えると、取引の印が多いほど、数が大きくなる点に注意しましょう。
- メインウィンドウの数には、取引の印も含まれる
- サブウィンドウの数は、メインとは別に数えられる
- 公式の数は例で、自分のチャートとは異なる
ObjectNameは、どんな場面で使うのか?
ObjectNameは、チャート上のオブジェクトを、順番に取り出して調べたいときに使います。ObjectsTotalで数を知り、ObjectNameで名前を取り出す流れです。
順番は、絞り込んだ中での通し番号
公式の説明では、順番は、サブウィンドウの番号と種類の条件で絞り込んだ中での、通し番号です。ObjectsTotalと同じ条件を渡すと、数と順番がそろいます。
- 順番は、絞り込んだ中での通し番号
- ObjectsTotalと同じ条件を渡すと、そろう
- サンプルは、0から数えている
名前が分かれば、ほかの関数へつなげられる
取り出した名前は、ほかのオブジェクト関数へ渡せます。たとえば、名前を指定して削除する関数は、ObjectDeleteとObjectsDeleteAllの記事にまとめています。
- 名前を取り出して、ほかの関数へ渡せる
- 削除や設定の前の、確認にも使える
- 名前の決まりは、自分のプログラムで決めておく
名前を変えると、イベントが2回起きる
公式の説明では、オブジェクトの名前を変えると、OnChartEventのイベントが2回発生します。古い名前の削除と、新しい名前の作成の、2つです。
名前を取り出したあとに、名前を変える処理を入れるときは、このイベントの動きも、頭に入れておくと安心です。
| 起きること | イベント |
|---|---|
| 古い名前 | 削除のイベント |
| 新しい名前 | 作成のイベント |
※公式の説明をもとにした、筆者の整理です。
公式の出力例は、名前の付き方の参考になる
ObjectNameの出力例には、メインウィンドウの名前として、時間足とオブジェクトの種類、数字を組み合わせたものが並んでいます。サブウィンドウにも、同じ形の名前が表示されています。
ただし、名前の付け方は、オブジェクトを作るときに決められます。自分で名前を付ける場合は、あとで見分けやすい決まりを、先に作っておくのがおすすめです。
- 名前は、オブジェクトを作るときに決められる
- 見分けやすい決まりを、先に作っておく
- 公式の名前は、あくまで出力例
公式のサンプルは、どう書かれているのか?
2つの関数には、それぞれ公式サンプルがあります。どちらも、サブウィンドウごとに、順番に処理していく短いスクリプトです。
ObjectsTotalは、ウィンドウごとに数を表示する
ObjectsTotalのサンプルは、まず、サブウィンドウの数を取得します。取得に失敗したときは、エラーの値を表示する作りです。
そのあと、ウィンドウの番号を0から順に回して、それぞれのオブジェクトの数を表示します。メインウィンドウと、番号つきのウィンドウで、表示の文が分かれています。
出力例は、メインウィンドウに数百個、サブウィンドウに数個、という形です。取引の印も含まれると、公式ページに説明があります。
- サブウィンドウの数を、先に取得する
- ウィンドウの番号を回して、数を表示する
- 出力例は、公式ページのコメントにある
ObjectNameは、ウィンドウごとに名前を表示する
ObjectNameのサンプルも、サブウィンドウの数を取得してから、ウィンドウごとに回します。ウィンドウごとに見出しを表示し、名前を1つずつ表示します。
メインウィンドウでは、名前が自動売買の印で始まるものを、飛ばしています。表示される番号は、回している番号なので、飛ばした分は、番号に抜けが出る作りです。
| サンプル | 主な流れ |
|---|---|
| ObjectsTotal | ウィンドウごとに、オブジェクトの数を表示する |
| ObjectName | ウィンドウごとに、オブジェクトの名前を表示する |
※公式サンプルの内容を、筆者が整理しました。
どう使い分ければよいのか?
2つは競合する関数ではなく、役割が違います。数を知りたいのか、名前を知りたいのかで、使い分けます。
数を知りたいなら、ObjectsTotalを選ぶ
いま何個あるのかを、確認したいときは、ObjectsTotalが向いています。繰り返しの回数を決めるときにも、使えます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
名前を知りたいなら、ObjectNameを選ぶ
どんな名前のオブジェクトがあるのかを、一覧で調べたいときは、ObjectNameが向いています。順番を回して、1つずつ取り出せます。
- オブジェクトの名前を、一覧で調べたい
- 順番を回して、1つずつ処理したい
- 名前をほかの関数へ渡したい
組み合わせるなら、数を数えてから名前を取り出す
公式のサンプルは、数を数える例と、名前を取り出す例に分かれています。実際には、先に数を数え、その回数だけ名前を取り出す形が、基本の流れです。









もう1つのコツは、数を数えるときと名前を取り出すときで、同じ条件を使うことです。サブウィンドウと種類の指定がずれると、順番がそろわなくなります。
- 数える条件と、取り出す条件をそろえる
- 取り出した名前は、まずログに出して確かめる
- 失敗時の戻り値は記載なしなので、空の名前に備える
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ObjectNameの順番は、0から始まるのか?
公式サンプルは、0から順に回しています。ただし、0から始まると明記した説明は、確認したページには記載なしでした。
- 公式サンプルは、0から回している
- 明記は、記載なし
ObjectNameが失敗したら、何が返るのか?
確認したページには、失敗したときの戻り値は、記載なしでした。範囲を超えた順番を渡すときは、自分の環境で動きを確かめてから使うのが安全です。
- 失敗時の戻り値は、記載なし
- 範囲を超える順番は、先に試す
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のObjectsTotalとObjectName、チャート上のオブジェクトの数を一度に数えられる手軽さと順番を指定して名前を取り出せる確かさどっちを選ぶ?」
数を知りたいならObjectsTotal、順番を指定して名前を取り出したいならObjectNameです。どちらも同期なので、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










