MQL5で日次のCSVログを書き出すEAを動かし続けると、
`MQL5/Files`フォルダの中に、
`20261101.csv`から`20261130.csv`まで、
1か月で30個近いファイルが並ぶことになります。
このまま半年、1年と動かし続ければ、ファイルの数は数百に膨れ上がり、
目的の日のログを探すだけでも一苦労になります。
この記事では、
`FolderCreate`・`FolderDelete`・
`FolderClean`という
MQL5のフォルダ操作関数を使って、
日次のCSVログを月別フォルダへ自動で振り分けるEAを解説します。
ファイルを移動する`FileMove`の使い方と、
MQL5のファイルアクセスを縛っている「サンドボックス」という制限の仕組みも扱います。
- なぜ日次CSVログはフォルダ単位の管理が必要になるのか
- MQL5のファイルサンドボックスとFILE_COMMONフラグの意味
- FolderCreateで月別フォルダを作る
- FileMoveで当日のログを月別フォルダへ移動する
- FolderCleanとFolderDeleteの違い:空にする/削除する
- 実際に動くコード全体:日次ログを月別フォルダに自動整理するEA
- コピペしてコンパイルが通らない・フォルダが作られないときに確認すること
- よくある質問
- 【MQL5入門】EAのCSVログを月別フォルダへ自動振り分け。FolderCreate/FolderDelete/FolderCleanでフォルダを管理する方法:まとめ
なぜ日次CSVログはフォルダ単位の管理が必要になるのか
まず、何が問題で、この記事が何を解決するのかを整理します。
既刊記事(FileOpen/FileWrite)で解決した範囲
FileOpen/FileWrite/FileCloseの記事では、
決済が起きるたびに1つのCSVファイルへ1行ずつ追記する方法を解説しました。
ですがこの記事は「1つのファイルに書き込む」ところまでが範囲で、
ファイルが増えた後にどう整理するかには触れていません。
この記事が解決する範囲:フォルダ単位の整理
本記事では、日付ごとに増えていくCSVファイルを、
`2026-11`のような月別フォルダへ自動で移動し、
さらに動作確認などで使った一時フォルダを安全にリセット・削除する方法まで扱います。
この記事で作るもの: 前日分のCSVログを検出します。
対応する月別フォルダ(無ければ`FolderCreate`で作成)へ、
`FileMove`で移動します。
さらに動作確認用の一時フォルダを`FolderClean`で空にしてから、
`FolderDelete`で削除します。
今回使う関数の役割分担
似た名前の関数が複数出てくるため、先に役割を整理しておきます。
| 関数 | 対象 | 役割 |
|---|---|---|
| FolderCreate | フォルダ | フォルダを新規作成する |
| FolderClean | フォルダ | フォルダの中身(ファイル・サブフォルダ)だけを全て削除する。フォルダ自体は残る |
| FolderDelete | フォルダ | 空のフォルダを削除する。中身が残っていると失敗する |
| FileMove | ファイル | ファイルを別の場所へ移動(またはリネーム)する |
MQL5のファイルサンドボックスとFILE_COMMONフラグの意味
フォルダ操作関数を使う前に、MQL5特有の制限を理解しておく必要があります。
許可されるのは2つの場所だけ
公式リファレンス(ファイル関数)によると、
MQL5はセキュリティ上の理由からファイルの扱いを厳しく制御しており、
MQL5の関数で操作できるファイル・フォルダは次の2箇所に限定されます。
- 端末ごとのローカルフォルダ:MT5のデータフォルダの中の`MQL5\Files\`
- 全端末共有の共通フォルダ:共通データフォルダの中の`Terminal\Common\Files\`
これ以外のパス、
例えば`C:\Users\`配下や他のドライブへ直接アクセスすることはできません。
common_flagの指定でどちらに作るかが決まる
`FolderCreate`・`FolderDelete`・`FolderClean`・
`FileMove`は、いずれも最後に近い引数で、
`common_flag`(または`mode_flags`)を受け取ります。
FolderCreate(folder_name, 0); //ローカルのMQL5\Filesに作成 FolderCreate(folder_name, FILE_COMMON); //共有のTerminal\Common\Filesに作成
用語: `FILE_COMMON`は、同じPC上の複数のMT5端末(または複数のEA)が、
同じフォルダを読み書きできるようにするフラグです。
便利ですが、別のEAが同じファイル名で書き込むと内容を上書きされる事故につながります。
複数のEAで共有する前提がない限り、通常は指定しない(ローカルのまま)方が安全です。
フォルダ操作もこのサンドボックスの対象
今回扱う`FolderCreate`・`FolderDelete`・
`FolderClean`も、ファイル関数と同じサンドボックスのルールに従います。
つまり、これらの関数で操作できるのも、
先ほどの2箇所のフォルダの中だけであり、
Windowsの任意のフォルダを作成・削除することはできません。
FolderCreateで月別フォルダを作る
ここから、実際にフォルダを作成する処理を見ていきます。
シグネチャと戻り値
公式リファレンス(FolderCreate)によると、シグネチャは次の通りです。
bool FolderCreate( string folder_name, //作成するフォルダ名(サブフォルダのパスを含めてよい) int common_flag=0 //0=ローカル、FILE_COMMON=共有フォルダ );
戻り値は、作成に成功すれば`true`、失敗すれば`false`です。
落とし穴:フォルダの存在確認にFileIsExistを使うとエラーになる
「フォルダが無い時だけ作りたい」と考えて、
先に存在確認をしようとすると、ここでつまずきます。
注意: FileIsExist()はファイルの存在確認専用の関数です。
「チェックされたファイルがサブディレクトリである場合、
FileIsExist()はfalseを返し、
エラー5018(ディレクトリであり、ファイルではない)が記録される」と明記されています。
つまり、フォルダの存在をFileIsExist()で確認しようとすると、
フォルダが実際には存在していてもfalseが返り、
「存在しない」と誤判定してしまいます。
対処:存在確認をせず毎回FolderCreateを呼ぶ
MQL5の公式リファレンスには、
「既に存在するフォルダに対して`FolderCreate()`を呼んだ場合に何が返るか」
は明記されていません。
この挙動に依存するコードを書くと将来的な仕様変更の影響を受けやすいため、
本記事では存在確認のステップそのものを省き、
フォルダが必要になるたびに、
`FolderCreate()`を無条件に呼ぶ書き方を採用します。
//存在確認はせず、必要なタイミングで毎回呼ぶ
FolderCreate("DealLogFolders\\2026-11", CommonFlag);
FileMoveで当日のログを月別フォルダへ移動する
フォルダができたら、ファイルをその中へ移動します。
シグネチャとFILE_REWRITEフラグ
公式リファレンス(FileMove)によると、シグネチャは次の通りです。
bool FileMove( const string src_file_name, //移動元のファイル名 int common_flag, //移動元の場所(0またはFILE_COMMON) const string dst_file_name, //移動先のファイル名(別フォルダのパスを含む) int mode_flags //0またはFILE_REWRITE );
移動先に同名のファイルが既に存在し、
かつ`FILE_REWRITE`を指定していない場合、
ファイルは上書きされずに`false`が返ります。
既存ファイルを上書きしてよい場合だけ`FILE_REWRITE`を渡してください。
FileMoveとFileCopyの違い: 似た関数に`FileCopy()`があります。
`FileMove()`は移動後に元の場所からファイルが消えるのに対し、
`FileCopy()`は元のファイルを残したまま複製を作ります。
月別フォルダへ「振り分ける」用途では元のファイルを残す必要がないため、
本記事では`FileMove()`を使います。
FolderCleanとFolderDeleteの違い:空にする/削除する
最後に、フォルダそのものを片付ける2つの関数を扱います。
FolderCleanはフォルダの中身を空にするだけ
公式リファレンス(FolderClean)によると、シグネチャは次の通りです。
bool FolderClean( string folder_name, //中身を空にするフォルダ名 int common_flag=0 //0=ローカル、FILE_COMMON=共有フォルダ );
公式リファレンスには「全てのファイルとサブディレクトリが削除されて回復不能なので、
この関数の使用には注意が必要」と明記されています。
フォルダ自体は残り、中のファイル・サブフォルダだけが削除される点が、
`FolderDelete()`との違いです。
FolderDeleteは空でないと失敗する
公式リファレンス(FolderDelete)によると、シグネチャは次の通りです。
bool FolderDelete( string folder_name, //削除するフォルダ名 int common_flag=0 //0=ローカル、FILE_COMMON=共有フォルダ );
公式リファレンスには「フォルダが空でない場合は削除できない」と明記されています。
中にファイルやサブフォルダが1つでも残っていると、
`FolderDelete()`は`false`を返します。
注意: フォルダを丸ごと削除したい場合は、
先に`FolderClean()`で中身を空にしてから、
`FolderDelete()`を呼ぶという2段階の手順が必要です。
FolderDelete()だけを呼んで、
「中身ごと消えるはず」と思い込むと、
中身が残っている限り何度呼んでも`false`が返り続け、
原因に気づきにくい不具合になります。
一時フォルダをリセットしてから削除する実例
動作確認のたびに増えていく一時ファイルを置く「一時フォルダ」を想定し、
EAの終了時に次の順番で片付けます。
FolderClean(TempFolder, CommonFlag); //中身を空にする FolderDelete(TempFolder, CommonFlag); //空になったフォルダを削除する
実際に動くコード全体:日次ログを月別フォルダに自動整理するEA
ここまでの要素をまとめた、実際にMetaEditorでコンパイルできるコードです。
//+------------------------------------------------------------------+
//| DealLogFolderOrganizer.mq5 |
//| Copyright 2026, FX-EA System Project Creator |
//| https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property copyright "Copyright 2026, FX-EA System Project Creator"
#property link "https://creator.fx-ea-system-project.com/"
#property version "1.00"
#property strict
input bool InpUseCommonFolder = false;//FILE_COMMONを使うか(複数端末で共有したい場合のみtrue)
string BaseFolder = "DealLogFolders";
string TempFolder = "DealLogFolders\\temp";
int CommonFlag = 0;
datetime lastCheckedDay = 0;
//+------------------------------------------------------------------+
//| 月別フォルダ名(BaseFolder\YYYY-MM)を返す |
//+------------------------------------------------------------------+
string MonthFolderName(datetime t)
{
MqlDateTime dt;
TimeToStruct(t, dt);
return(StringFormat("%s\\%04d-%02d", BaseFolder, dt.year, dt.mon));
}
//+------------------------------------------------------------------+
//| その日のログファイル名(BaseFolder\YYYYMMDD.csv)を返す |
//+------------------------------------------------------------------+
string DailyLogFileName(datetime t)
{
MqlDateTime dt;
TimeToStruct(t, dt);
return(StringFormat("%s\\%04d%02d%02d.csv", BaseFolder, dt.year, dt.mon, dt.day));
}
//+------------------------------------------------------------------+
//| 当日分のログに1行書き込む(決済ログ本体の書き方は既刊記事を参照) |
//+------------------------------------------------------------------+
void WriteDailyLogLine(datetime t)
{
int handle = FileOpen(DailyLogFileName(t), FILE_READ|FILE_WRITE|FILE_CSV|FILE_ANSI, ',', CommonFlag);
if(handle == INVALID_HANDLE)
{
Print("当日ログの作成に失敗しました。エラーコード=", GetLastError());
return;
}
FileSeek(handle, 0, SEEK_END);
FileWrite(handle, TimeToString(t, TIME_DATE|TIME_SECONDS), "sample-row");
FileClose(handle);
}
//+------------------------------------------------------------------+
//| 前日分のログファイルを月別フォルダへ移動する |
//+------------------------------------------------------------------+
void ArchiveYesterdayLog()
{
datetime yesterday = TimeCurrent() - 86400;
string srcFile = DailyLogFileName(yesterday);
if(!FileIsExist(srcFile, CommonFlag))
return;//前日分のファイル自体が無ければ何もしない
string monthDir = MonthFolderName(yesterday);
if(!FolderCreate(monthDir, CommonFlag))
{
Print("月別フォルダの作成に失敗しました: ", monthDir, " エラーコード=", GetLastError());
return;
}
MqlDateTime dt;
TimeToStruct(yesterday, dt);
string dstFile = StringFormat("%s\\%04d%02d%02d.csv", monthDir, dt.year, dt.mon, dt.day);
if(!FileMove(srcFile, CommonFlag, dstFile, 0))
{
Print("ログの移動に失敗しました: ", srcFile, " -> ", dstFile, " エラーコード=", GetLastError());
return;
}
PrintFormat("前日分のログを月別フォルダへ移動しました: %s", dstFile);
}
//+------------------------------------------------------------------+
//| 一時フォルダをその都度まっさらな状態にする |
//+------------------------------------------------------------------+
void ResetTempFolder()
{
//既存フォルダへの挙動は未確認のため、存在確認はせず毎回FolderCreateを呼ぶ
FolderCreate(TempFolder, CommonFlag);
if(!FolderClean(TempFolder, CommonFlag))
Print("一時フォルダのクリーンに失敗しました。エラーコード=", GetLastError());
}
//+------------------------------------------------------------------+
//| Expert initialization function |
//+------------------------------------------------------------------+
int OnInit()
{
CommonFlag = InpUseCommonFolder ? FILE_COMMON : 0;
FolderCreate(BaseFolder, CommonFlag);
ResetTempFolder();
ArchiveYesterdayLog();
WriteDailyLogLine(TimeCurrent());
lastCheckedDay = TimeCurrent();
return(INIT_SUCCEEDED);
}
//+------------------------------------------------------------------+
//| Expert tick function |
//+------------------------------------------------------------------+
void OnTick()
{
MqlDateTime now, last;
TimeToStruct(TimeCurrent(), now);
TimeToStruct(lastCheckedDay, last);
if(now.day != last.day)
{
ArchiveYesterdayLog();
lastCheckedDay = TimeCurrent();
}
}
//+------------------------------------------------------------------+
//| Expert deinitialization function |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
FolderClean(TempFolder, CommonFlag); //中身を空にしてから
FolderDelete(TempFolder, CommonFlag); //削除する(空でなければ失敗する設計を体感できる)
}
//+------------------------------------------------------------------+
補足: WriteDailyLogLine()は解説用に簡略化した1行書き込みです。
実際のEAで決済ごとに詳細な行を追記したい場合は、
FileOpen/FileWrite/FileCloseの記事の、
`OnTradeTransaction`を使った実装に差し替えてください。
MetaEditorで実際に動かす手順
- MT5の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
- 「ファイル」→「新規作成」→「Expert Advisor(テンプレートを使用)」を選び、名前を「DealLogFolderOrganizer」にして作成する
- テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
- F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- デモ口座のチャートへドラッグ&ドロップし、「ファイル」→「データフォルダを開く」→「MQL5/Files/DealLogFolders」に当日分のCSVファイルが作成されているか確認する
コピペしてコンパイルが通らない・フォルダが作られないときに確認すること
- コンパイルエラーになる: `FolderCreate()`・`FolderDelete()`・`FolderClean()`はMQL4には存在しないMQL5独自の関数のため、MQL4用のコードに混在させていないか確認する
- 月別フォルダが作られない: 前日分のファイル(`DailyLogFileName`で前日の日付になるファイル)が実際に存在するか確認する。初回起動した日は前日分のファイルが無いため、`ArchiveYesterdayLog()`は何もせず終了する(これは正常な動作)
- `FolderDelete()`が常に`false`を返す: 一時フォルダの中にまだファイルが残っていないか確認する。先に`FolderClean()`を呼んでいるかを見直す
- パス区切りで文字化け・コンパイルエラーになる: `\\`(バックスラッシュ2つ)で区切っているか確認する(MQL5の文字列リテラルでは`\`は特殊文字のため2つ重ねる必要がある)
- 共有フォルダに保存したいのにローカルに作られる: `InpUseCommonFolder`を`true`にし、`CommonFlag`に`FILE_COMMON`が渡っているか確認する
よくある質問
フォルダ操作関数についてよく検索されている疑問を、3つにまとめて回答します。
FolderCreateは複数階層のフォルダを一度に作成できますか?
公式リファレンスには、
サブフォルダを含むパスを一度に作成できるかどうかの明記がありません。
確実に動かすには、
まず親フォルダ(`”DealLogFolders”`)に対して、
`FolderCreate()`を呼びます。
続けて、その下の月別フォルダに対しても`FolderCreate()`を呼ぶというように、
親フォルダから順番に作成することをおすすめします。
FolderDeleteで削除したフォルダは復元できますか?
できません。MQL5のファイル操作にゴミ箱のような仕組みは無く、
`FolderDelete()`・`FolderClean()`で、
削除したファイル・フォルダは即座に失われます。
重要なログを扱う場合は、削除や移動の前に別の場所へコピーを残すことを検討してください。
FolderCreate/FolderDelete/FolderCleanはMQL4にもありますか?
docs.mql4.comのファイル関数一覧にはこれらのフォルダ操作関数は見当たらず、
MQL5で新たに追加された関数です。
MQL4でフォルダ相当の整理をしたい場合は、
ファイル名自体に日付・月を含めて管理するなど別の工夫が必要になります。
【MQL5入門】EAのCSVログを月別フォルダへ自動振り分け。FolderCreate/FolderDelete/FolderCleanでフォルダを管理する方法:まとめ
この記事では、MQL5のFolderCreate・FolderDelete・
FolderCleanを使って、
日次のCSVログを月別フォルダへ自動で振り分ける方法を解説しました。
ポイントは、フォルダの存在確認にFileIsExist()を使うと、
エラー5018になること、
FolderDelete()はフォルダが空でないと失敗すること、
空にしたい場合は先にFolderClean()を呼ぶ必要があることの3点です。
これらのフォルダ操作も、
MQL5のファイルサンドボックス(ローカルのMQL5/Filesか、
FILE_COMMON指定時の共有フォルダのみ)の制限下で動くという前提は、
FileOpen/FileWrite/FileCloseの記事と共通です。
ログの「書き込み」と「整理」をセットで理解しておくことで、
長期運用するEAのログ管理に活用できます。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント