EAがMQL5/Files配下に日次CSVログを吐き続けると、
ファイルの数はいつか必ず増えすぎます。
FolderCreate/FolderDelete/FolderCleanの記事では、
日次ログを月別フォルダへ振り分けて整理する方法を解説しました。
ですがこの記事は「フォルダを作る・移す・空にする」ところまでが範囲で、
フォルダの中にどんなファイルが何個残っているかを調べる方法には触れていません。
この記事では、
`FileFindFirst`・`FileFindNext`・
`FileFindClose`という
MQL5のファイル検索関数を使って、
ファイル名を1つずつ知らなくても、
パターンに一致する複数のCSVファイルをまとめて見つける方法を解説します。
見つけたファイルの更新日時を`FileGetInteger`で調べ、
保持期間を過ぎた古いログだけを`FileDelete`で削除する、
実際に動くログローテーションEAまで作ります。
なぜ「ファイルを検索して処理する」機能が必要なのか
まず、何が問題で、この記事が何を解決するのかを整理します。
既刊記事で解決した範囲:ファイル名が分かっている前提の操作
FileOpen/FileWriteの記事やFolderCreate/FolderDeleteの記事は、
いずれも「操作したいファイル名・フォルダ名を事前に自分で知っている」
ことが前提でした。
この記事が解決する範囲:ファイル名が分からない複数ファイルの検索
本記事で扱うのは、次のような状況です。
`DealLogFolders\2026-11\`の中に、
何個のCSVファイルがあるか分からない状況です。
古いファイルだけを狙って消したいのに、
ファイル名のリストを自分では持っていない状況です。
この記事で作るもの: 月別フォルダの中のCSVファイルを
`FileFindFirst`/`FileFindNext`で検索します。
見つけた各ファイルの更新日時を`FileGetInteger`で調べます。
保持期間(日数)を過ぎたファイルだけを
`FileDelete`で削除するログローテーションEAです。
今回使う関数の役割分担
似た用途の関数が複数出てくるため、先に役割を整理しておきます。
| 関数 | 対象 | 役割 |
|---|---|---|
| FileFindFirst | ファイル検索 | パターンに一致する最初のファイルを探し、検索ハンドルを得る |
| FileFindNext | ファイル検索 | 同じ検索条件で次に一致するファイルを探す |
| FileFindClose | ファイル検索 | 検索ハンドルを閉じ、リソースを解放する |
| FileGetInteger | ファイル情報 | ファイルを開かずに更新日時・サイズなどの情報を取得する |
| FileDelete | ファイル削除 | 指定したファイルを1つ削除する |
FileFindFirstで検索を開始する
ここから、実際にファイルを検索する処理を見ていきます。
シグネチャと戻り値
公式リファレンス(FileFindFirst)によると、シグネチャは次の通りです。
long FileFindFirst( const string file_filter, //検索フィルタ(\Filesディレクトリ相対) string& returned_filename, //見つかったファイル名(拡張子付き、パスは含まない) int common_flag=0 //0=ローカル、FILE_COMMON=共有フォルダ );
戻り値は、一致するファイルが見つかれば検索ハンドル(`long`)、
1件も見つからなければ`INVALID_HANDLE`です。
file_filterの書式:フォルダ名+ワイルドカード
`file_filter`には、
フォルダのパスとワイルドカード(`*`)を組み合わせて指定します。
//DealLogFolders\2026-11\ フォルダ内の、拡張子.csvのファイル全てが対象 string filter = "DealLogFolders\\2026-11\\*.csv";
用語: returned_filenameに返るのは、
ファイル名部分(拡張子を含む)だけです。
フォルダのパスは含まれないため、
実際にファイルを開く際は、自分でフォルダのパスと組み合わせてフルパスを作る必要があります。
該当ファイルが1件も無い場合はINVALID_HANDLE
対象のフォルダが空、またはパターンに一致するファイルが1件も無い場合、
`FileFindFirst()`は`INVALID_HANDLE`を返します。
この戻り値を確認せずに次の処理へ進むと、
無効なハンドルに対して`FileFindNext()`を呼んでしまうため、
必ず`INVALID_HANDLE`かどうかを確認してから先へ進んでください。
FileFindNext/FileFindCloseで検索結果を順番に処理する
最初の1件が見つかったら、残りのファイルも順番に取得していきます。
do-whileループの定型パターン
公式リファレンス(FileFindNext)によると、シグネチャは次の通りです。
bool FileFindNext( long search_handle, //FileFindFirst()が返した検索ハンドル string& returned_filename //次に見つかったファイル名 );
`FileFindFirst()`で最初の1件を処理したあと、
`FileFindNext()`が`false`を返すまで、
`do-while`で繰り返すのが定型のパターンです。
do
{
//ここでfnameを使った処理(更新日時の確認・削除判定など)を行う
}
while(FileFindNext(searchHandle, fname));
MQL4にも同名で存在する(思い込みに注意)
補足: 「ファイル検索はMQL5の新機能」と思い込みがちですが、
MQL4にも同名のFileFindFirst()・
FileFindNext()・FileFindClose()が存在し、
シグネチャもMQL5版と同一です。
この記事のテーマで両バージョンの差を探すなら、
関数の有無ではなく、
次のH2で扱うFileGetIntegerの引数の型の方に
注意が必要です。
FileFindCloseを呼び忘れるとどうなるか
注意: 公式リファレンス(FileFindClose)には、
「システムリソースを解放するために呼び出されなければならない」と明記されています。
検索処理が終わったら、検索した件数に関わらず、
必ずFileFindClose()を呼んでください。
特に、途中でreturnしてループを抜けるような分岐を追加する場合、
その分岐でもFileFindClose()を呼び忘れないように気をつけてください。
FileGetIntegerでファイルの更新日時を調べる
検索で見つけた各ファイルについて、削除してよいかどうかを判定します。
2つのオーバーロードとproperty_idの制限
公式リファレンス(FileGetInteger)によると、`FileGetInteger`には2つの書式があります。
//(1)既に開いているファイルのハンドルを使う書式
long FileGetInteger(int file_handle, ENUM_FILE_PROPERTY_INTEGER property_id);
//(2)ファイル名だけで調べる書式(開かずに済む)
long FileGetInteger(const string file_name, ENUM_FILE_PROPERTY_INTEGER property_id,
bool common_folder=false);
ファイル名だけで調べる(2)の書式は、
公式リファレンスにより指定できる`property_id`が、
`FILE_EXISTS`・`FILE_CREATE_DATE`・
`FILE_MODIFY_DATE`・`FILE_ACCESS_DATE`・
`FILE_SIZE`の5つに限定されています。
今回の用途(更新日時の確認)はこの5つに含まれるため、
わざわざ`FileOpen()`でファイルを開く必要がありません。
FILE_MODIFY_DATEで経過日数を計算する
`FILE_MODIFY_DATE`を指定すると、
ファイルの最終更新日時が`datetime`相当の`long`値で返ります。
現在時刻との差を秒数で求め、1日=86400秒で割れば、経過日数が分かります。
long modifyDate = FileGetInteger(fullPath, FILE_MODIFY_DATE, InpUseCommonFolder); int ageDays = (int)((TimeCurrent() - (datetime)modifyDate) / 86400);
落とし穴:ファイル名版だけcommon_folderがbool型
注意: FolderCreate・FileDelete・FileFindFirstは、
最後の引数がint型のcommon_flagでした。
FileGetIntegerのファイル名版だけ、
最後の引数がbool型のcommon_folderです。
FILE_COMMONをそのまま渡すと型が合わずエラーになるため、
この関数だけはtrue/falseを渡してください。
FileDeleteで古いファイルだけを削除する
最後に、保持期間を過ぎたと判定したファイルを実際に削除します。
シグネチャと戻り値
公式リファレンス(FileDelete)によると、シグネチャは次の通りです。
bool FileDelete( const string file_name, //削除するファイル名 int common_flag=0 //0=ローカル、FILE_COMMON=共有フォルダ );
戻り値は、削除に成功すれば`true`、失敗すれば`false`です。
削除したファイルは復元できない
注意: MQL5のファイル操作にゴミ箱のような仕組みはありません。
FileDelete()で削除したファイルは即座に失われ、元に戻せません。
保持期間の日数(InpRetentionDays)は、
十分に余裕を持った値から始めることを推奨します。
削除前に必ず確認ログを出す設計にする
いきなり無条件で削除するコードを書くと、
意図せず必要なファイルまで消してしまうリスクがあります。
本記事のコードでは、削除の成否にかかわらず`Print()`で結果を出力し、
実際に何が削除されたかを「エキスパート」タブで必ず確認できるようにしています。
実際に動くコード全体:保持期間を過ぎた日次ログを自動削除するEA
ここまでの要素をまとめた、実際にMetaEditorでコンパイルできるコードです。
//+------------------------------------------------------------------+
//| DealLogRetentionCleaner.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)
input int InpRetentionDays = 90;//この日数より古いログを削除する
string BaseFolder = "DealLogFolders";
int CommonFlag = 0;
datetime lastCheckedDay = 0;
//+------------------------------------------------------------------+
//| 月別フォルダ名(BaseFolder\YYYY-MM)を返す(既刊FolderCreate記事と同じ命名)|
//+------------------------------------------------------------------+
string MonthFolderName(datetime t)
{
MqlDateTime dt;
TimeToStruct(t, dt);
return(StringFormat("%s\\%04d-%02d", BaseFolder, dt.year, dt.mon));
}
//+------------------------------------------------------------------+
//| 指定フォルダ内のCSVファイルを検索し、保持期間より古いものを削除する |
//+------------------------------------------------------------------+
void CleanupOldLogsInFolder(string folderPath)
{
string filter = folderPath + "\\*.csv";
string fname;
long searchHandle = FileFindFirst(filter, fname, CommonFlag);
if(searchHandle == INVALID_HANDLE)
{
Print("検索条件に一致するファイルがありませんでした: ", filter);
return;
}
int deletedCount = 0;
do
{
string fullPath = folderPath + "\\" + fname;
long modifyDate = FileGetInteger(fullPath, FILE_MODIFY_DATE, InpUseCommonFolder);
if(modifyDate <= 0)
{
Print("更新日時を取得できませんでした: ", fullPath);
continue;
}
int ageDays = (int)((TimeCurrent() - (datetime)modifyDate) / 86400);
if(ageDays < InpRetentionDays)
continue;//保持期間内なので削除しない
if(FileDelete(fullPath, CommonFlag))
{
deletedCount++;
PrintFormat("古いログを削除しました: %s (%d日経過)", fullPath, ageDays);
}
else
Print("削除に失敗しました: ", fullPath, " エラーコード=", GetLastError());
}
while(FileFindNext(searchHandle, fname));
FileFindClose(searchHandle);
PrintFormat("フォルダ%sのクリーンアップ完了。削除件数=%d", folderPath, deletedCount);
}
//+------------------------------------------------------------------+
//| Expert initialization function |
//+------------------------------------------------------------------+
int OnInit()
{
CommonFlag = InpUseCommonFolder ? FILE_COMMON : 0;
CleanupOldLogsInFolder(MonthFolderName(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)
{
CleanupOldLogsInFolder(MonthFolderName(TimeCurrent()));
lastCheckedDay = TimeCurrent();
}
}
//+------------------------------------------------------------------+
MetaEditorで実際に動かす手順
- MT5の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
- 「ファイル」→「新規作成」→「Expert Advisor(テンプレートを使用)」を選び、名前を「DealLogRetentionCleaner」にして作成する
- テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
- F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- デモ口座のチャートへドラッグ&ドロップし、「エキスパート」タブに検索・削除の結果(件数・ファイル名)が表示されるか確認する
コピペしてコンパイルが通らない・削除されないときに確認すること
- コンパイルエラーになる(common_folder周り): `FileGetInteger()`の第3引数に`FILE_COMMON`を直接渡していないか確認する。この引数だけ`bool`型のため`true`/`false`を渡す必要がある
- 何も削除されない: `InpRetentionDays`の値が、実際のファイルの経過日数より大きくなっていないか確認する。テスト時は一時的に小さい値(例: 1)にすると動作を確認しやすい
- `INVALID_HANDLE`になる: `file_filter`に渡したフォルダパスが実際に存在するか、`FolderCreate()`で先に作成済みか確認する
- 一部のファイルだけ処理されない: `returned_filename`にはサブフォルダの名前も一致すれば返る可能性がある。フォルダ名が偶然`*.csv`のパターンに一致していないか確認する
- 共有フォルダのファイルが検索されない: `InpUseCommonFolder`を`true`にし、`CommonFlag`に`FILE_COMMON`が渡っているか確認する
よくある質問
ファイル検索・削除関数についてよく検索されている疑問を、3つにまとめて回答します。
FileFindFirstのワイルドカードは*.csv以外も使えますか?
公式リファレンスには、ワイルドカードの詳細な一致規則の明記がありません。
確実に動く書き方として、本記事ではフォルダ名\*.csvのような、
公式サンプルと同じ単純な形のみを紹介しています。
複雑なパターンを使いたい場合は、まず単純な形で動作を確認してから、
少しずつ条件を変えて試すことをおすすめします。
複数の月別フォルダをまとめて検索できますか?
FileFindFirst自体はサブフォルダをまたいだ再帰検索をしません。
複数の月別フォルダを対象にしたい場合は、
本記事のCleanupOldLogsInFolder()を、
対象フォルダのパスを変えて複数回呼び出す設計にしてください。
削除ではなくバックアップしてから消したい場合はどうすればよいですか?
FileDelete()の前に、FileMoveの記事で解説したFileMove()で、
別のバックアップ用フォルダへ移動する処理を挟んでください。
移動してしまえば、元のフォルダからは消えますが、ファイル自体は残ります。
【MQL5入門】複数の日次CSVログをFileFindFirst/FileFindNextで検索し、古いログだけFileDeleteで自動削除する方法:まとめ
この記事では、MQL5のFileFindFirst・
FileFindNext・FileFindCloseを使って、
ファイル名が分からない複数のCSVログをまとめて検索する方法を解説しました。
見つけたファイルはFileGetIntegerで更新日時を調べ、
保持期間を過ぎたものだけをFileDeleteで削除する、
ログローテーションEAとして実装しました。
ポイントは、FileFindClose()を必ず呼んでリソースを解放することと、
FileGetIntegerのファイル名版だけ最後の引数がbool型である点です。
この仕組みは、FolderCreate/FolderDelete/FolderCleanの記事で作った月別フォルダと組み合わせることで、
ログを「作る」
「整理する」
「探して片付ける」までを一通りカバーできます。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント