この記事を開いてくださったこと、心から感謝しています。自作のプログラムから、端末のフォルダの場所や、自分自身の名前を知りたいと考えている人も、きっと多いはずです。
結論から言うと、端末の名前、フォルダ、画面の色テーマなど、端末側の文字情報を知りたいときはTerminalInfoString、動いているプログラム自身の名前や置き場所を知りたいときはMQLInfoStringです。調べる対象が違う関数です。
また、不正なIDを渡したときの動きや、テスターでの動きなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の引数、戻り値、取れる項目、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
TerminalInfoStringとMQLInfoStringは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも文字列を返しますが、調べる対象が違います。
TerminalInfoStringは、端末の文字情報を返す
TerminalInfoStringは、整数でIDを渡すと、端末に関する文字列を返す関数です。公式の説明では、IDは、端末の文字情報を表す列挙型の値のどれかです。
ページには、対象の項目が文字列型でなければならない、とも書かれています。整数や小数の項目は、TerminalInfoIntegerやTerminalInfoDoubleで読みます。
- 端末に関する文字列を返す
- IDは、端末の文字情報の列挙型から選ぶ
- 整数や小数の項目は、別の関数で読む
MQLInfoStringは、プログラム自身の文字情報を返す
MQLInfoStringは、動いているMQL5プログラムに関する文字列を返す関数です。公式の説明では、IDは、プログラム情報の文字列の列挙型の値のどれかです。
端末ではなく、いま動いているEAやスクリプト自身が、調べる対象です。整数の情報は、別の関数のMQLInfoIntegerで読みます。整数側の違いは、MQLInfoIntegerとTerminalInfoIntegerの記事で整理しています。
- 動いているプログラム自身の文字列を返す
- IDは、プログラム情報の文字列の列挙型から選ぶ
- 整数の情報は、MQLInfoIntegerで読む
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | TerminalInfoString | MQLInfoString |
|---|---|---|
| 調べる対象 | 端末 | 動いているプログラム自身 |
| 戻り値 | 文字列 | 文字列 |
| 取れる項目 | 10種類 | 3種類 |
| 代表的な項目 | 端末名、フォルダの場所、色テーマ | プログラム名、置き場所 |
| 不正なIDの動き | 記載なし | 記載なし |
| テスターでの動き | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
TerminalInfoStringは、どんな情報を返してくれるのか?
TerminalInfoStringは、端末の名前や、フォルダの場所などを読みたいときに使います。公式の一覧から、どんな項目があるかを確認します。
端末の名前や、会社名、言語を読める
公式の一覧には、端末の言語、会社名、端末の名前の3つがあります。それぞれ、1行の短い説明が付いています。
ただし、値の書式や、具体的な例は、公式のページには書かれていません。実際にどんな文字が返るかは、自分の環境で確かめるのが安心です。
| 項目 | 公式の説明 |
|---|---|
| TERMINAL_LANGUAGE | 端末の言語 |
| TERMINAL_COMPANY | 会社名 |
| TERMINAL_NAME | 端末の名前 |
※公式の説明をもとにした、筆者の整理です。
フォルダの場所を、3種類読める
フォルダの場所は、3種類あります。端末を起動したフォルダ、端末のデータを置くフォルダ、同じパソコンに入れたすべての端末で共通のフォルダです。
公式には、ファイルの操作ができるのは2つのフォルダだけで、その場所はデータ用と共通用の項目で調べられる、と書かれています。確かめるために、スクリプトで表示する方法も紹介されています。
| 項目 | 公式の説明 |
|---|---|
| TERMINAL_PATH | 端末を起動したフォルダ |
| TERMINAL_DATA_PATH | 端末のデータを置くフォルダ |
| TERMINAL_COMMONDATA_PATH | すべての端末で共通のフォルダ |
※公式の説明をもとにした、筆者の整理です。
パソコンの情報と、色テーマも読める
残りの項目は、CPUの名前、CPUの構造、OSの名前、色テーマの名前です。公式には、色テーマの値の候補として、明るいものと暗いものが書かれています。
OSの項目は、説明では「OSの名前」ですが、公式サンプルの出力例には、番号付きの文字列が表示されています。説明と例の書き方が少し違うので、実際の値は自分で確かめましょう。
- CPUの名前と、CPUの構造を読める
- OSの項目は、説明と例の書き方が違う
- 色テーマは、明るいか暗いかの名前を読める
MQLInfoStringは、どんな情報を返してくれるのか?
MQLInfoStringは、動いているプログラム自身の名前や置き場所を読みたいときに使います。公式の一覧から、項目を確認します。
プログラムの名前と置き場所を読める
公式の一覧には、動いているプログラムの名前と、その置き場所があります。ログに自分の名前を出したいときや、保存先を決めたいときに役立ちそうです。
公式サンプルは、スクリプトの中で、この2つを読んで、ログに表示しています。出力例には、名前と、拡張子付きのファイルの場所が出ています。
- プログラム自身の名前を読める
- プログラムの置き場所を読める
- ログに自分の名前を出すのに役立つ
OpenBLASで失敗した関数の名前も読める
3つ目の項目は、失敗したOpenBLASの関数の名前です。公式では、OpenBLASの説明ページへのリンクが付いています。
ただし、どんなときに空になるのか、どのように設定されるのかは、公式のページには書かれていません。使うときは、小さく試して、動きを確かめてから使いましょう。
- 失敗したOpenBLAS関数の名前を読める
- 空になる条件は、記載なし
- 使う前に、小さく試す
置き場所の項目名は、ページ内で表記が違う
置き場所のIDは、一覧の表では、名前の先頭がMQL5になっています。ところが、同じページのサンプルコードでは、先頭がMQLの名前で書かれています。
どちらが正しいのかは、公式のページには書かれていません。実際に書くときは、コンパイルして確かめるのが確実です。
- 一覧の表と、サンプルで表記が違う
- どちらが正しいかは、記載なし
- コンパイルして確かめるのが確実
端末のフォルダとプログラムの置き場所は、どう使い分けるのか?
2つの関数は、名前が似ていますが、役割は別です。調べたい対象が、端末なのか、プログラム自身なのかで、使い分けます。
端末のフォルダを知りたいなら、TerminalInfoStringを選ぶ
データ用のフォルダや、共通のフォルダを知りたいときは、TerminalInfoStringが向いています。ファイルを読み書きする前に、場所を確かめたいときにも使えます。
ファイルの扱いそのものは、別の関数の役割です。ここでは、場所を知る関数だけを比べています。
- データ用のフォルダを知りたい
- 共通のフォルダを知りたい
- 色テーマや端末名を知りたい
自分の名前を知りたいなら、MQLInfoStringを選ぶ
ログに、どのプログラムが書いたのかを残したいときは、MQLInfoStringが向いています。プログラム自身の名前と置き場所が、そのまま読めるためです。
FX口座・ツールの比較一覧もあわせて確認してみてください。
どちらも、記載のない点がある
公式のページには、不正なIDを渡したときの戻り値や、エラーの扱いは、書かれていません。空の文字列を返す場合があるかどうかも、記載なしです。
ストラテジーテスターでの動きや、返る文字列の最大の長さも、書かれていません。プログラムの種類による違いも、記載がありませんでした。
- 不正なIDの動きは、記載なし
- テスターでの動きは、記載なし
- 文字列の最大の長さは、記載なし
実際に使うとき、どんな順番で進めればよいのか?
最後に、2つの関数を使うときの、確認の順番を整理します。まずはスクリプトで、値を表示してみるのが安心です。
まずは、スクリプトで値を表示する
最初は、スクリプトで、気になる項目を読んで、ログに表示します。公式サンプルと同じ流れで、フォーマット付きの表示を使うと、見やすくなります。
- スクリプトで、項目を読む
- ログに、値を表示する
- 自分の環境の値を、目で確かめる
次に、読んだ値を、実際の処理に使う
値の書式が分かったら、実際の処理に使います。たとえば、フォルダの場所を、ログに出す文の一部に入れる、といった使い方です。
空の文字列が返った場合の処理も、一緒に入れておくと安心です。公式には、空になるかどうかが書かれていないためです。
- 書式を確かめてから使う
- 空の文字列の場合の処理を入れる
- ログに場所を残しておく
最後に、環境を変えて確かめる
パソコンやOSが違うと、返る文字列も変わる場合があります。公式サンプルの出力例は、特定の環境のものなので、そのまま当てはまるとは限りません。









- 環境を変えて、値を確かめる
- 出力例は、そのまま当てはまらない場合がある
- 記載なしの点は、小さく試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
2つの関数は、同時に使ってもよいのか?
公式のページには、同時に使うことへの制限は書かれていません。調べる対象が違うので、必要に応じて、両方を呼ぶことも考えられます。
- 同時に使う制限は、記載なし
- 対象が違うので、両方を使う場面もある
文字列以外の情報は、どう読むのか?
整数の情報は、TerminalInfoIntegerとMQLInfoInteger、小数の情報は、TerminalInfoDoubleで読みます。文字列の関数では、読めません。
- 整数は、整数用の関数で読む
- 小数は、TerminalInfoDoubleで読む
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?」
端末側の文字情報ならTerminalInfoString、プログラム自身の名前や置き場所ならMQLInfoStringです。どちらも、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










