MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のObjectsTotalとObjectName、チャート上のオブジェクトの数を一度に数えられる手軽さと順番を指定して名前を取り出せる確かさどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のObjectsTotalとObjectName、チャート上のオブジェクトの数を一度に数えられる手軽さと順番を指定して名前を取り出せる確かさどっちを選ぶ?

2026 11/17
PR
FX自動売買と人工知能
2026年11月17日
MQL5のObjectsTotalとObjectNameの比較

この記事を開いてくださったこと、心から感謝しています。チャート上に並んだ線やラベルを、プログラムから一覧で扱いたいと考えている人も、きっと多いはずです。

結論から言うと、オブジェクトの数を知りたいならObjectsTotal、順番を指定して名前を取り出したいならObjectNameです。数える関数と、名前を取り出す関数という違いがあり、2つを組み合わせて使うのが基本です。

また、失敗したときの戻り値など、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。

この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。

MQL5のObjectsTotalとObjectNameの違いをまとめたインフォグラフィック
目次

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つずつ処理したい
  • 名前をほかの関数へ渡したい

組み合わせるなら、数を数えてから名前を取り出す

公式のサンプルは、数を数える例と、名前を取り出す例に分かれています。実際には、先に数を数え、その回数だけ名前を取り出す形が、基本の流れです。

数える関数と名前を取り出す関数だと分かって、全体像が整理できました。調べてよかったです。
どちらも同期だと分かって、呼び出す回数を気にする大切さが身にしみました。
Kenichi
Kenichi
記載なしの点が分かると、試すときの確認項目が増えて、落ち着いて進められます。調べておいてよかったです。
2つの役割の違いが見えたら、場面ごとの使い方が整理されて、コードを書くのが楽しみになりました。

もう1つのコツは、数を数えるときと名前を取り出すときで、同じ条件を使うことです。サブウィンドウと種類の指定がずれると、順番がそろわなくなります。

  • 数える条件と、取り出す条件をそろえる
  • 取り出した名前は、まずログに出して確かめる
  • 失敗時の戻り値は記載なしなので、空の名前に備える

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

ObjectNameの順番は、0から始まるのか?

公式サンプルは、0から順に回しています。ただし、0から始まると明記した説明は、確認したページには記載なしでした。

  • 公式サンプルは、0から回している
  • 明記は、記載なし

ObjectNameが失敗したら、何が返るのか?

確認したページには、失敗したときの戻り値は、記載なしでした。範囲を超えた順番を渡すときは、自分の環境で動きを確かめてから使うのが安全です。

  • 失敗時の戻り値は、記載なし
  • 範囲を超える順番は、先に試す

この記事の例は、実際の結果なのか?

いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。

  • 公式サンプルの内容をもとにした説明
  • 実際の動きとは異なる場合がある

まとめ:「MQL5のObjectsTotalとObjectName、チャート上のオブジェクトの数を一度に数えられる手軽さと順番を指定して名前を取り出せる確かさどっちを選ぶ?」

数を知りたいならObjectsTotal、順番を指定して名前を取り出したいならObjectNameです。どちらも同期なので、記載のない点は自分の環境で確かめてから使いましょう。

  • 数えるならObjectsTotal
  • 名前を取り出すならObjectName
  • 記載なしの点は自分で確かめる

仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • MQL5 リファレンス(ObjectsTotal)
  • MQL5 リファレンス(ObjectName)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のObjectGetStringとObjectSetString、オブジェクトの文字情報を読み取れる確かさと文字や説明を書き換えられる手軽さどっちを選ぶ?
  • MQL5のObjectCreateとObjectFind、チャートへ線やラベルを置ける自由さと同じ名前のオブジェクトがあるか確かめられる確実さどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    2026年11月17日
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
    2026年11月17日
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    2026年11月17日
  • MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    2026年11月17日
  • MQL5のExpertRemoveとIsStoppedの比較
    MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?
    2026年11月17日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次