この記事を開いてくださったこと、心から感謝しています。MQL5のEAで、結果やデータをファイルに残したいと考えた人も多いはずです。
結論から言うと、人が開いて中身を確かめたいならCSVかTXT、構造体や配列をそのまま保存したいならBINが向いています。
ただし、速さや、ファイルの大きさの上限は、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つのファイルの形式の仕組み・前提・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
FILE_CSVとFILE_BINは、そもそも何が違うのか?
まずは、FileOpenの公式ページで説明されている、形式の基本的な性格を整理します。
FILE_CSVとFILE_TXTは、文字として書き出す
MQL5公式リファレンスによると、FILE_CSVは、書き込む項目をすべて文字列に変換し、区切り文字で区切るファイルです。FILE_TXTは、CSVと同じですが、区切り文字を考慮しない単純なテキストファイルです。
区切り文字を指定しないとき、CSVでは、タブが使われます。TXTでは、区切り文字は使われません。区切り文字を0にすると、どちらでも区切りなしになります。
- CSVは区切り文字で区切る
- TXTは区切り文字を考慮しない
- CSVの初期の区切りはタブ
FILE_BINは、変換せずにそのまま書き出す
FILE_BINは、バイナリの読み書きの形式で、文字列との変換をしません。FileWriteのページには、BINファイルへは、データを変換せず、そのまま書く、と書かれています。
文字列は、終わりの印を付けずに書かれる、という説明もあります。人が開いても、そのままでは読みにくい形式です。
- 変換せずに書き出す
- 文字列は終わりの印なしで書く
- そのままでは人が読みにくい
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | CSV・TXT | BIN |
|---|---|---|
| 書き方 | 文字に変換 | そのまま |
| 区切り | 自動で入る | なし |
| 行の終わり | \r\nが付く | 付かない |
| 人が読む | 読みやすい | 読みにくい |
※公式の説明をもとにした、筆者の整理です。
CSVやTXTに書くと、どうなるのか?
次に、文字として書き出す1つ目の方法を見ていきます。
FileWriteは、区切りと行の終わりを自動で付ける
FileWriteは、CSVやTXTに、文字に変換したデータを書く関数です。区切り文字が0でなければ、データの間に、自動で入ります。書いたあとには、行の終わりを表す\r\nが付きます。
引数に使えるのは、基本の型だけです。配列、構造体、クラスは使えません。引数の数は、256個までです。戻り値は、書き込んだバイト数です。
- 区切りは自動で入る
- 行の終わりが付く
- 引数は256個まで
数値や日時は、決まった形の文字になる
公式ページには、数値の形の説明があります。double型などは、小数点以下16桁で出力されます。より短い形のほうを使うため、通常の表記か、指数の表記になる場合があります。
bool型は、trueかfalseの文字で書かれます。日時は、年.月.日 時:分:秒の形です。桁数を変えたいときは、DoubleToStringを使う、と書かれています。
| 型 | 書かれる形 |
|---|---|
| double | 小数点以下16桁 |
| bool | trueかfalse |
| datetime | 年.月.日 時:分:秒 |
※公式の説明から読み取れる内容を、筆者が整理しました。
細かい前提は、確認できなかった
color型やenum型の書かれ方は、確認したページに記載なしでした。整数の形も、記載なしです。すでにあるファイルをFILE_WRITEで開いたとき、上書きか追記かも、記載なしでした。
BINに書くと、どうなるのか?
続いて、そのまま書き出す2つ目の方法を見ていきます。
FileWriteStructは、構造体をそのまま書く
FileWriteStructは、構造体の中身を、ファイルの今の位置から、BINファイルへ書く関数です。構造体には、文字列、動的配列、仮想関数を含めてはいけない、と書かれています。
サイズを指定すると、その分のバイト数だけ書けます。指定しないか、構造体より大きいときは、全体が書かれます。戻り値は、書いたバイト数です。
- 文字列は含められない
- 動的配列も含められない
- 戻り値はバイト数
FileWriteArrayは、配列をまとめて書く
FileWriteArrayは、文字列以外の型の配列を、BINファイルへ書く関数です。開始の位置と、書く個数を指定できます。戻り値は、バイト数ではなく、書いた要素の個数です。
FileWriteStructの戻り値はバイト数なので、2つで数え方が違います。結果を使う場合は、この違いを意識しましょう。
| 関数 | 戻り値 |
|---|---|
| FileWrite | 書いたバイト数 |
| FileWriteStruct | 書いたバイト数 |
| FileWriteArray | 書いた要素の個数 |
※公式の説明から読み取れる内容を、筆者が整理しました。
細かい前提は、確認できなかった
サイズを構造体より小さく指定したときの扱いは、確認したページに記載なしでした。エラーのときの戻り値も、記載なしです。BOMの有無も、記載なしでした。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの使い方を比べます。
例の前提を、そろえる
EAが、取引の結果をファイルに残す場合を考えます。1つは、人が表計算ソフトで開いて見たい場合です。もう1つは、同じEAが、あとで読み込み直して使いたい場合です。
- 人が開いて確かめたい
- あとでEAが読み直したい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
人が見るなら、CSVが分かりやすい
CSVなら、FileWriteに値を並べるだけで、区切りと行の終わりが自動で付きます。人が開いたときも、文字として読めるので、中身を確かめやすいです。
ただし、doubleの桁数が多くなるので、見やすくしたい場合は、DoubleToStringで桁数を指定する、という方法があります。
- 値を並べるだけで書ける
- 開いて中身を確かめられる
- 桁数はDoubleToStringで調整
読み直すなら、BINが手軽
構造体のまま書けるので、項目ごとに文字へ変換する手間が少なくて済みます。ただし、構造体に文字列を含められないので、文字は別の形で持つ必要があります。
たとえば、数値だけの構造体にして、文字の情報は、別のCSVに残す、という分け方が考えられます。仮の例なので、実際の設計は、各自で決めてください。
| 目的(仮) | CSV・TXT | BIN |
|---|---|---|
| 人が確認する | 向いている | 向かない |
| 構造体のまま読み直す | 手間がかかる | 向いている |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
人が確かめたいなら、CSVかTXTを選ぶ
結果を目で見て確かめたいなら、CSVかTXTが向いています。ファイルと変数の使い分けは、グローバル変数とファイルの比較記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
構造体のまま保存したいなら、BINを選ぶ
構造体や数値の配列を、そのまま保存して読み直したいなら、BINが向いています。テスターの結果をまとめる方法は、OnTesterの記事で整理しています。
- 構造体をそのまま保存したい
- 数値の配列をまとめて書きたい
- 文字列は別の形で持つ
書いたデータは、FileFlushで確実に残す
FileFlushのページには、ファイルへ書いたデータが、実際に反映されるまで時間がかかる場合がある、と書かれています。すぐに保存したいときは、FileFlushを使う、という説明です。
使わない場合、ディスクに書かれていないデータは、FileCloseで閉じたときに書かれます。ただし、頻繁に呼ぶと、プログラムの速さに影響する場合がある、とも書かれています。
- FileFlushで早めに書き込む
- 使わないと閉じたときに書かれる
- 頻繁に呼ぶと速さに影響する
小さく試して、動きを確かめる
いきなり本番のEAで使わず、小さなスクリプトで、CSVとBINの両方に書いてみましょう。書いたあとに、人の目で開いて確かめると、違いがよく分かります。









もう1つのコツは、ファイルを開く処理を、1か所の関数にまとめておくことです。形式を変えたくなったときも、その関数だけを直せば済むので、見直しやすくなります。
また、FileOpenは、開けなかったときにINVALID_HANDLEを返す、と書かれています。開いた直後に、この値を確かめておくと、書き込みの失敗に早く気づけます。
さらに、ファイルの置き場所も確かめておきましょう。公式ページでは、端末のMQL5のFilesフォルダか、テスト中は、テスト用のエージェントのフォルダ、と説明されています。FILE_COMMONを付けると、共通のフォルダになります。
反対に、ファイルの場所をプログラムの外から変えることはできません。安全のため、ファイルの操作は、決められた範囲の中に限られる、と公式ページに書かれています。
- 開く処理を1か所にまとめる
- 開いた直後にINVALID_HANDLEを確かめる
- 置き場所を確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
文字コードは、どうなるのか?
FileOpenのページには、FILE_ANSIを付けないと、テキストファイルは、変換なしのUnicodeとして読まれる、と書かれています。特定の文字コードで読むなら、FILE_ANSIとコードページを指定します。
- FILE_ANSIなしはUnicodeで読む
- 特定の文字コードならFILE_ANSIを付ける
- 書くときの初期値は記載なし
テスターでは、どうなるのか?
公式ページには、テスト中は、テスト用のエージェントのフォルダの中のFilesが使われる、と書かれています。それ以外のテスター中の細かい動きは、記載なしでした。
- テスト用エージェントのフォルダを使う
- 細かい動きは記載なし
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のFILE_CSVとFILE_BIN、人が開いて読める分かりやすさと構造体をそのまま保存できる手軽さどっちを選ぶ?」
人が確かめたいならCSVかTXT、構造体のまま保存したいならBINが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










