この記事を開いてくださったこと、心から感謝しています。プログラムが動く環境を、自分で確かめる方法を知りたいと考えている人も、きっと多いはずです。
結論から言うと、動かしているプログラム自身の状態を調べたいときはMQLInfoInteger、端末全体の環境を調べたいときはTerminalInfoIntegerです。調べる対象が、プログラムか端末かで、選ぶ関数が分かれます。
また、不正な番号を渡したときの動きなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割、調べられる項目、使い分け、確認の順番を整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
MQLInfoIntegerとTerminalInfoIntegerは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つは動いているプログラムの情報を返し、もう1つは端末の情報を返します。
MQLInfoIntegerは、プログラムの状態を返す
MQLInfoIntegerは、動いているMQL5プログラムの整数の情報を返す関数です。引数は、調べたい項目を表す番号が1つで、戻り値はint型です。
調べられる項目は、メモリの使用量、プログラムの種類、テスターで動いているか、取引の許可があるか、といったプログラム自身に関するものです。
- 動いているプログラムの情報を返す
- 引数は、項目の番号が1つ
- 戻り値は、int型
TerminalInfoIntegerは、端末の状態を返す
TerminalInfoIntegerは、クライアント端末の整数の情報を返す関数です。引数と戻り値の形は、MQLInfoIntegerと同じで、番号を渡すとint型の値が返ります。
調べられる項目は、端末のビルド番号、サーバーへの接続、画面の大きさ、パソコンのメモリやCPUの数など、端末とパソコンの環境に関するものです。
- 端末の情報を返す
- 引数と戻り値の形は、同じ
- 環境に関する項目が多い
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | MQLInfoInteger | TerminalInfoInteger |
|---|---|---|
| 調べる対象 | 動いているプログラム | クライアント端末 |
| 引数 | 項目の番号 | 項目の番号 |
| 戻り値 | int型 | int型 |
| 例 | メモリ、種類、テスター | ビルド、接続、画面 |
| 不正な番号の動き | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
MQLInfoIntegerでは、どんな項目を調べられるのか?
MQLInfoIntegerで調べられる項目は、公式の定数のページにまとまっています。主なものを、種類ごとに整理します。
メモリとハンドルの使用状況を調べられる
使えるメモリの上限と、使っているメモリの量を、MB単位で調べられます。また、使用中のオブジェクトのハンドルの数も、調べられます。
公式サンプルは、メモリの上限と使用量を読み取って、MB単位で表示します。サンプルのコメントには、使用量が2MBという例が載っています。
- メモリの上限を調べられる
- メモリの使用量を調べられる
- ハンドルの数も調べられる
プログラムの種類と許可を調べられる
プログラムの種類は、スクリプト、EA、インジケーター、サービスの4種類で返ります。DLLの許可、取引の許可、シグナルの変更の許可も、調べられます。
公式のサンプルは、種類の値を専用の型に直して、スクリプトかEAかインジケーターかを、メッセージで表示します。
- 種類は、4つのうちのどれか
- DLLの許可を調べられる
- 取引の許可を調べられる
テスターや最適化の状態を調べられる
テスターで動いているか、最適化の途中か、ビジュアルモードか、といった実行の場面も調べられます。デバッグやプロファイラーで動いているかも、確かめられます。
| 項目 | 調べられること |
|---|---|
| テスター | テスターで動いているか |
| 最適化 | 最適化の途中か |
| ビジュアルモード | ビジュアルで動いているか |
| フォワード | フォワードテストの途中か |
| デバッグ | デバッグ中か |
※公式の定数のページの内容を、筆者が整理しました。
TerminalInfoIntegerでは、どんな項目を調べられるのか?
TerminalInfoIntegerで調べられる項目は、MQLInfoIntegerよりも数が多く、端末とパソコンの環境を幅広く確かめられます。
接続と許可の状態を調べられる
取引サーバーへ接続しているか、MQL5のコミュニティへ接続しているかを、調べられます。メールやFTP、スマホへの通知の許可も、別々に調べられます。
メールとFTPの許可は、SendMailとSendFTPの記事で扱っています。通知の許可は、AlertとSendNotificationの記事が参考になります。
- サーバーへの接続を調べられる
- メールやFTPの許可を調べられる
- スマホ通知の許可も調べられる
パソコンの環境を調べられる
CPUのコアの数、パソコンの物理メモリ、端末が使えるメモリ、ファイル用の空き容量も、MB単位などで調べられます。64ビット版かどうかも、確かめられます。
公式サンプルは、ビルド番号と64ビット版かどうかを読み取って、メッセージで表示します。コメントには、64ビット版で、ビルド4330という例が載っています。
- CPUのコアの数を調べられる
- メモリと空き容量を調べられる
- 64ビット版かどうかを調べられる
画面の大きさやキーの状態も調べられる
画面の幅と高さ、端末ウィンドウの位置、画面の細かさを表す値も、調べられます。矢印キーなど、キーボードの状態を返す項目も、用意されています。
画面の細かさの値には、96を基準にした拡大率の計算例も、公式のページに載っています。画面に部品を置く作り方の参考になります。
- 画面の幅と高さを調べられる
- 端末の位置を調べられる
- キーの状態も調べられる
同じ名前の項目は、どう使い分ければよいのか?
取引の許可とDLLの許可は、どちらの関数でも調べられます。同じ名前の項目なので、違いを知っておくと安心です。
取引とDLLの許可は、両方に項目がある
公式の定数のページでは、取引の許可とDLLの許可が、プログラム用と端末用の両方に用意されています。プログラム用は、動いているプログラムの許可を表します。
端末用は、端末全体の許可を表します。2つの値が食い違う場合の説明は、確認したページには、記載なしでした。両方を調べて、確かめる作り方が安心です。
- プログラム用は、そのプログラムの許可
- 端末用は、端末全体の許可
- 食い違うときの説明は、記載なし
メモリの項目は、対象が違う
メモリの項目も、両方にあります。プログラム用は、そのプログラムが使うメモリで、端末用は、端末やパソコン全体のメモリです。
調べる対象が違うので、数字の大きさも変わります。どちらを見ているのかを、変数の名前で分かるようにしておくと、読み間違いを防げます。
- プログラム用は、そのプログラムのメモリ
- 端末用は、端末全体のメモリ
- 変数名で、対象を分かりやすくする
テスターかどうかは、プログラム側で調べる
テスターで動いているかの項目は、プログラム用の側にあります。端末用の側には、確認したページでは、見当たりませんでした。
たとえば、メールを送る関数はテスターで動かないので、先にテスターかどうかを調べる、という使い方が考えられます。これは筆者の考えです。
- テスターかは、プログラム側で調べる
- 端末側には、見当たらなかった
- 送る関数の前に調べる使い方もある
どう使い分ければよいのか?
2つは、調べる対象が違う関数です。プログラムのことを知りたいのか、端末のことを知りたいのかで、使い分けます。
プログラムの状態を知りたいなら、MQLInfoIntegerを選ぶ
自分のプログラムの種類、メモリの使用量、テスターで動いているかを知りたいときは、MQLInfoIntegerが向いています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
端末の環境を知りたいなら、TerminalInfoIntegerを選ぶ
サーバーへの接続、画面の大きさ、パソコンのメモリやCPUなど、端末の環境を知りたいときは、TerminalInfoIntegerが向いています。
- サーバーへの接続を確かめたい
- 画面の大きさを知りたい
- パソコンの環境を知りたい
迷ったら、両方で確かめる
許可のように、両方に項目がある場合は、両方を調べて確かめると安心です。片方だけで判断すると、見落としが出るかもしれません。
- 両方に項目があれば、両方を調べる
- 食い違いがないか、確かめる
- 記載なしの点は、小さく試す
実際に使うとき、どんな順番で進めればよいのか?
最後に、2つの関数を使うときの、確認の順番を整理します。小さな確認から、順に進めるのが安心です。
まずは、スクリプトで値を表示してみる
最初に、公式サンプルのように、スクリプトで値を読み取って、ログに表示します。自分の環境で、どんな値が返るのかを、確かめます。
- スクリプトで、値を表示する
- 自分の環境の値を、確かめる
- 項目の番号を、見直す
次に、使う項目を絞る
調べられる項目は多いので、自分のプログラムに必要なものだけに絞ります。必要な項目の一覧を、先に書き出しておくと、迷いません。
- 必要な項目を、書き出す
- プログラム側か端末側かを、決める
- 同じ名前の項目は、両方を調べる
最後に、プログラムへ組み込む
動きが分かってから、自分のプログラムへ組み込みます。初期化の処理の中で調べて、条件に合わなければ、早めに知らせる作り方も考えられます。









もう1つのコツは、調べた値をログに残しておくことです。あとで見返すと、環境の違いによる動きの差に、気づきやすくなります。
- 調べた値を、ログに残す
- 環境の違いを、見比べる
- 記載なしの点は、小さく試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
2つの関数は、戻り値の形が違うのか?
いいえ、公式の説明では、どちらも番号を1つ渡して、int型の値を受け取ります。違うのは、調べる対象と、使える項目です。
- どちらも、int型の値を返す
- 違いは、調べる対象と項目
存在しない番号を渡すと、どうなるのか?
確認したページには、その説明が見当たりませんでした。戻り値や、エラーの扱いは、記載なしです。自分の環境で、確かめましょう。
- 戻り値は、記載なし
- エラーの扱いも、記載なし
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?」
プログラムの状態を知るならMQLInfoInteger、端末の環境を知るならTerminalInfoIntegerです。同じ名前の項目は両方を調べ、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










