既刊filefindfirst-filefindnext-mql5.mdの記事では、
保持期間を過ぎた日次CSVログを、
`FileDelete()`で自動削除するログローテーションEAを解説しました。
ですが、`FileDelete()`で消したファイルは、
公式リファレンスにも明記されている通り復元できません。
この記事では、削除する前に`FileCopy()`で、
バックアップフォルダへ複製を残す方法と、
元ファイルが消える`FileMove()`との違い、
上書き保護の仕組み(`FILE_REWRITE`フラグ)を解説します。
なぜ削除の前にコピーが必要なのか
まず、この記事が解決する範囲を整理します。
既刊記事(FileFindFirst/FileDelete)で解決した範囲
FileFindFirst/FileFindNextの記事では、
ワイルドカードでファイルを検索し、
更新日時が古いものだけを`FileDelete()`で削除する、
という設計を解説しました。
この記事が解決する範囲:削除前のバックアップ
本記事では、削除そのものではなく、
削除する前に1つ手順を増やし、
`FileCopy()`でバックアップフォルダへ複製を残してから削除する、
という安全な手順を扱います。
注意: 既刊foldercreate-folderdelete-mql5.mdの、
FAQでも触れた通り、
`FileDelete()`・`FolderClean()`で削除したファイルに、
ゴミ箱のような復元手段はありません。
FileCopy()のシグネチャと4つの引数
ここから、関数の中身を見ていきます。
シグネチャ全文
公式リファレンス(FileCopy)によると、シグネチャは次の通りです。
bool FileCopy( const string src_file_name, //複製元のファイル名 int common_flag, //複製元の場所(0またはFILE_COMMON) const string dst_file_name, //複製先のファイル名(別フォルダのパスを含む) int mode_flags //0またはFILE_REWRITE(必要ならFILE_COMMONと組み合わせる) );
各引数の役割
| 引数 | 役割 |
|---|---|
| src_file_name | 複製したい元のファイル名 |
| common_flag | 元ファイルがローカルか共有フォルダかを示すフラグ |
| dst_file_name | 複製後のファイル名(別フォルダのパスを含めてよい) |
| mode_flags | 上書きを許可するFILE_REWRITE、共有フォルダに置くFILE_COMMONのみ指定可 |
戻り値は、複製に成功すれば`true`、
失敗すれば`false`です。
FileCopyとFileMoveの違い:元ファイルは残るか消えるか
似た関数との役割分担を整理します。
既刊FolderCreate記事での位置づけ
FolderCreate/FolderDelete/FileMoveの記事では、
`FileMove()`を使って、
前日分のログを月別フォルダへ「振り分ける」処理を実装しました。
`FileMove()`は移動が完了すると、
元の場所からファイルが消える関数です。
使い分けの判断基準
| 関数 | 元ファイル | 向いている用途 |
|---|---|---|
| FileMove | 消える | フォルダへの振り分け・リネーム |
| FileCopy | 残る | 削除・移動の前に残す安全なバックアップ |
判断基準: 「元ファイルをそのまま使い続けたいか」で選びます。
使い続けないなら`FileMove()`、
使い続けながら複製も残したいなら`FileCopy()`です。
落とし穴:上書き保護とFILE_REWRITEフラグ
実際に使う前に、もう1つ確認が必要です。
デフォルトでは上書きされない
複製先に同名のファイルが既に存在し、
かつ`FILE_REWRITE`を指定していない場合、
複製は実行されず`false`が返ると明記されています。
バックアップ先に同名ファイルがあるとどうなるか
注意: 同じ日に2回バックアップ処理が走った場合など、
バックアップ先に既に同名ファイルが存在していると、
`FILE_REWRITE`を指定しない限り2回目は`false`を返します。
これはバグではなく、意図しない上書きを防ぐための仕様です。
バックアップ用途では、
毎回必ず最新内容で上書きしたいとは限らないため、
本記事では`FILE_REWRITE`を指定せず、
「既に今日分のバックアップがあれば何もしない」という、
安全側の挙動をそのまま採用します。
実際に動くコード全体:削除前に必ずバックアップへコピーするEA
既刊filefindfirst-filefindnext-mql5.mdの、
ログローテーションEAに、
バックアップ処理を追加した完成形です。
//+------------------------------------------------------------------+
//| SafeLogRotationWithBackup.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 int InpRetentionDays = 30;//この日数を過ぎたログをバックアップ後に削除する
string LogFolder = "DealLogFolders";
string BackupFolder = "DealLogFolders\\backup";
//+------------------------------------------------------------------+
//| 1件のファイルを削除する前に、バックアップフォルダへ複製する |
//+------------------------------------------------------------------+
bool BackupBeforeDelete(string fileName)
{
FolderCreate(BackupFolder, 0); //無ければ作成(既存への挙動は未確認のため毎回呼ぶ)
string src = LogFolder + "\\" + fileName;
string dst = BackupFolder + "\\" + fileName;
//既にバックアップ済みなら上書きせず、それ以外は新しく複製する
if(FileIsExist(dst, 0))
return(true);
if(!FileCopy(src, 0, dst, 0))
{
Print("バックアップに失敗したため削除を見送りました: ", fileName,
" エラーコード=", GetLastError());
return(false);
}
return(true);
}
//+------------------------------------------------------------------+
//| 保持期間を過ぎたログを、バックアップしてから削除する |
//+------------------------------------------------------------------+
void RotateOldLogs()
{
string fileName;
long search = FileFindFirst(LogFolder + "\\*.csv", fileName);
if(search == INVALID_HANDLE)
return;
datetime cutoff = TimeCurrent() - InpRetentionDays * 86400;
do
{
string fullPath = LogFolder + "\\" + fileName;
long modifyTime = (long)FileGetInteger(fullPath, FILE_MODIFY_DATE, false);
if((datetime)modifyTime < cutoff)
{
//バックアップに成功した場合だけ削除する
if(BackupBeforeDelete(fileName))
FileDelete(fullPath, 0);
}
}
while(FileFindNext(search, fileName));
FileFindClose(search);
}
//+------------------------------------------------------------------+
//| Expert initialization function |
//+------------------------------------------------------------------+
int OnInit()
{
RotateOldLogs();
return(INIT_SUCCEEDED);
}
//+------------------------------------------------------------------+
MetaEditorで実際に動かす手順
- MT5の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
- 「ファイル」→「新規作成」→「Expert Advisor(テンプレートを使用)」を選び、名前を「SafeLogRotationWithBackup」にして作成する
- テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
- F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- デモ口座のチャートへドラッグ&ドロップし、「MQL5/Files/DealLogFolders/backup」に複製が作られてから元ファイルが消えることを確認する
コピペして動かない・バックアップが増えないときに確認すること
- コンパイルエラーになる: `FileCopy()`の第2引数(common_flag)と第4引数(mode_flags)の順番を公式シグネチャ通りに渡しているか確認する
- バックアップが1度しか作られない: 2回目以降は`FileIsExist()`が`true`を返すため意図的にスキップされる仕様(本記事の落とし穴)なので、異常ではない
- 元ファイルが削除されない: `BackupBeforeDelete()`が`false`を返していないか、Experts/Journalタブでエラーコードを確認する
- バックアップフォルダが作られない: `BackupFolder`のパス区切りが`\\`(バックスラッシュ2つ)になっているか確認する
よくある質問
FileCopy()についてよく検索されている疑問を、3つにまとめて回答します。
コピー先のフォルダが存在しない場合はどうなりますか?
公式リファレンスには、
コピー先のフォルダが無い場合の挙動について明記がありません。
確実に動かすには、
本記事のコードのように、
先に`FolderCreate()`を呼んでおくことをおすすめします。
FILE_REWRITEを指定すれば毎回最新内容で上書きできますか?
できます。`mode_flags`に`FILE_REWRITE`を渡すと、
複製先に同名ファイルがあっても上書きされます。
本記事では「既にバックアップがあれば何もしない」設計を優先し、
`FILE_REWRITE`は指定していませんが、
常に最新化したい用途では付け替えてください。
FileCopyはMQL4にもありますか?
docs.mql4.comのファイル関数一覧には、
`FileCopy`という項目は見当たらず、
MQL5で追加された関数です。
MQL4でファイルを複製したい場合は、
元ファイルを1行ずつ読み込み、
別のファイルへ書き込み直すという自作の処理が必要になります。
【MQL5入門】FileCopy()で削除前に安全なバックアップを残す方法について解説してみた(FileMoveとの違い・FILE_REWRITEの上書き保護):まとめ
この記事では、既刊filefindfirst-filefindnext-mql5.mdの、
ログローテーションEAに、
`FileCopy()`による削除前のバックアップ処理を追加する方法を解説しました。
ポイントは、`FileMove()`は元ファイルが消え、
`FileCopy()`は元ファイルが残ること、
複製先に同名ファイルがあると、
`FILE_REWRITE`無しでは上書きされないことの2点です。
削除や移動を伴う自動処理を書くときは、
本記事のように「先にコピーを残してから消す」設計にしておくと、
予期しない削除事故を防げます。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント