この記事を開いてくださったこと、心から感謝しています。複数のEAやスクリプトの間で、値や記録をやり取りしたいと考えた人も多いはずです。
結論から言うと、数値を1つ手軽に共有したいならグローバル変数、文字や表のような形のある記録を残したいならファイルが向いています。
ただし、同時に書き込んだときの安全性や処理の速さは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの方法の仕組み・寿命・置き場所・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
グローバル変数とファイルは、そもそも何が違うのか?
まずは、公式リファレンスで説明されている、2つの方法の基本的な性格を整理します。
グローバル変数は、端末の中で共有する数値
MQL5公式リファレンスによると、グローバル変数は、クライアント端末の中で動くすべてのMQL5プログラムから、同時に使える変数です。プログラム内で宣言する、ふつうの大域変数とは別のものだと書かれています。
値を入れるGlobalVariableSetは、引数に名前とdouble型の値を取ります。変数がなければ作られ、成功すると最後に変更した時刻が返ります。失敗したときは0が返り、GetLastErrorで理由を調べます。
- 端末内のすべてのプログラムから使える
- GlobalVariableSetはdouble型の値を入れる
- 失敗すると0が返る
確認したページで型として示されていたのはdoubleだけでした。文字列を入れられるかどうかは、確認したページに記載なしです。
ファイルは、形のある記録を残す入れ物
ファイルは、FileOpenで開き、FileWriteなどで書き込みます。FileOpenは成功するとファイルのハンドルを返し、失敗するとINVALID_HANDLEを返します。
開くときには、読み込み・書き込み・CSV・テキスト・バイナリなどのフラグを組み合わせて指定します。形式を選べるので、数値だけでなく、文字や複数の列も保存できます。
- FileOpenでハンドルを受け取る
- フラグで形式や読み書きを指定する
- 文字や複数の列も保存できる
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | グローバル変数 | ファイル |
|---|---|---|
| 入れられるもの | double型の数値 | 文字・数値・表など |
| 使える範囲 | 同じ端末内のプログラム | フラグ次第で端末をまたげる |
| 手軽さ | 名前と値だけで済む | 開く・書く・閉じるが必要 |
| 同時書き込みの安全性 | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
グローバル変数で共有すると、どうなるのか?
次に、数値を手軽に共有する1つ目の方法を見ていきます。
名前は63文字以内で、4週間触られないと消える
公式ページによると、グローバル変数の名前は63文字を超えないようにします。また、最後にアクセスしてから4週間たつと、端末から自動的に削除される、という説明があります。
ここでいうアクセスには、値の設定だけでなく、読み取りも含まれると書かれています。使い続けている変数は残りますが、長く使わない変数は消えるので、必要なら作り直す前提で書くと安心です。
- 名前は63文字以内
- 最後のアクセスから4週間で自動削除
- 読み取りもアクセスに含まれる
一時的な変数は、端末の終了とともに消える
GlobalVariableTempで作る変数は、端末が動いている間だけ存在し、端末を終了すると自動で削除されます。作ったあとは、ふつうのグローバル変数と同じ方法で読み書きできます。
ふつうの変数は、端末の終了時にディスクへ保存されます。GlobalVariablesFlushを呼ぶと、その保存を自分のタイミングで強制できますが、一時的な変数はこの保存の対象になりません。
同時に使ったときの安全性は、確認できなかった
複数のプログラムが同時に書き込んだときに、値が壊れないのかは、確認した4つのページに記載なしでした。値がすぐ他のプログラムに見えるのかも、記載なしです。
- 同時書き込みの安全性は記載なし
- 値が他に見えるまでの早さは記載なし
- 複数の端末をまたぐ共有は記載なし
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
ファイルで共有すると、どうなるのか?
続いて、形のある記録を残す2つ目の方法を見ていきます。
置き場所は、決まったフォルダの中に限られる
公式ページによると、MQL5の命令で扱うファイルは、端末のMQL5\Filesという、サンドボックスの中に置きます。絶対パスで外のフォルダを指定する書き方は、誤った方法として示されています。
FILE_COMMONを付けると、すべてのクライアント端末で共有されるフォルダ(Terminal\Common\Files)に置けます。ストラテジーテスターでは、テスター用のエージェントのフォルダが使われると書かれています。
| 場面 | 置き場所 |
|---|---|
| ふつうに開く | 端末のMQL5\Files |
| FILE_COMMONを付ける | 全端末で共有のフォルダ |
| テスターで動かす | エージェントのMQL5\files |
※公式の説明から読み取れる内容を、筆者が整理しました。
複数のプログラムで読み書きするには、共有のフラグが要る
FILE_SHARE_READは複数のプログラムからの読み込み、FILE_SHARE_WRITEは複数のプログラムからの書き込みを許すフラグです。公式ページには、この2つの説明がありますが、短い説明にとどまっています。
フラグを付けないとどうなるのか、ロックの仕組みはどうなっているのかは、確認したページに記載なしでした。複数のプログラムで同じファイルを使うなら、動きを自分で確かめる必要があります。
- FILE_SHARE_READで共有の読み込み
- FILE_SHARE_WRITEで共有の書き込み
- ロックの仕組みは記載なし
FileWriteは、区切りと改行を自動で入れる
CSVやテキストのファイルにFileWriteで書くと、区切り文字が自動で入り、書くたびに改行が付きます。配列や構造体は渡せず、渡せるのは基本の型だけで、引数は256個までです。
書き込まれる形も決まっています。doubleは小数点以下16桁までで、短くなるほうの形式になります。boolはtrueかfalse、日時は年月日と時分秒の形で書かれます。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの使い方を比べます。
例の前提を、そろえる
2つのEAのうち、片方が作った「いま動かしてよいか」の合図を、もう片方が読む場合を考えます。さらに、1日の終わりに、記録を表の形で残したい場合も考えます。
- 合図を1つ共有したい
- 1日の終わりに記録を残したい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
合図の共有なら、グローバル変数が軽い
合図は、1か0のような数値1つで足ります。グローバル変数なら、名前を決めて値を入れ、もう片方が読むだけです。ファイルを開いて閉じる手間がなく、コードも短くなります。
たとえば、片方のEAが合図の変数に1を入れ、もう片方が毎回その値を見て動くかどうかを決める、という流れが考えられます。仮の例なので、実際の使い方は環境で確かめてください。
- 名前と値だけで済む
- 開く・閉じる手間がない
- コードが短くなる
記録を残すなら、ファイルが向いている
日付や項目名、複数の数値を表の形で残したいなら、ファイルのほうが向いています。CSV形式で書けば、あとで表計算ソフトでも開けます。
グローバル変数は、1つの名前に1つのdouble型の値しか入れられないため、表の形の記録には向きません。ただし、ファイルは開く・書く・閉じるの手順が増えるので、書き忘れや閉じ忘れに気をつけたいところです。
| 流れ(仮) | グローバル変数 | ファイル |
|---|---|---|
| 合図の共有 | 1つの値で足りる | 手間が増える |
| 記録の保存 | 表の形には向かない | CSVで残せる |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
数値1つの共有なら、グローバル変数を選ぶ
合図や設定値のような数値を、手軽にやり取りしたいなら、グローバル変数が向いています。自作のイベントで知らせる方法は、OnChartEventの比較記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
記録や文字を残すなら、ファイルを選ぶ
あとで見返したい記録や、文字を含む情報を残したいなら、ファイルが向いています。呼ばれるタイミングの考え方は、OnTickとOnTimerの比較記事で整理しています。
- 記録を見返したい
- 文字や複数の列を残したい
- 表計算ソフトでも開きたい
小さく試して、動きを確かめる
いきなり本番のEAで試さず、小さなスクリプトで、書いた値が読めるかを確かめましょう。値を入れてから端末を再起動し、残っているかを見ておくと、寿命の感覚もつかめます。









書き込みに失敗したときは、GetLastErrorで理由を調べる癖をつけておくと、あとで原因を追いやすくなります。グローバル変数のSetは失敗すると0を返し、FileOpenはINVALID_HANDLEを返すので、戻り値を毎回確かめる書き方にしておきましょう。
- 小さなスクリプトで確かめる
- 端末を再起動して残るかを見る
- 戻り値とGetLastErrorを確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
再起動しても、グローバル変数は残るのか?
公式ページによると、端末は終了時にグローバル変数をディスクへ保存します。一方、一時的な変数は終了時に削除されると書かれています。ふつうの変数が再起動後も残るとはっきり書いた文は、確認できませんでした。
急な故障では、データを失う場合があるという注意もあります。大事な値は、GlobalVariablesFlushで保存のタイミングを自分で決める方法があります。
グローバル変数に、文字列は入れられるのか?
確認したページで示されていたのは、double型の値だけでした。文字列を直接入れられるかは、記載なしです。文字を共有したいときは、ファイルを使う方法が考えられます。
- 確認できたのはdouble型だけ
- 文字列は記載なし
- 文字ならファイルが候補
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のグローバル変数とファイル、数値を手軽に共有できる身軽さと文字や表も残せる自由さどっちを選ぶ?」
数値1つを手軽に共有するならグローバル変数、文字や表の記録を残すならファイルが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










