既刊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つ確認が必要です。

デフォルトでは上書きされない

公式リファレンス(FileCopy)には、

複製先に同名のファイルが既に存在し、

かつ`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で実際に動かす手順

  1. MT5の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
  2. 「ファイル」→「新規作成」→「Expert Advisor(テンプレートを使用)」を選び、名前を「SafeLogRotationWithBackup」にして作成する
  3. テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
  4. F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
  5. デモ口座のチャートへドラッグ&ドロップし、「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点です。

削除や移動を伴う自動処理を書くときは、

本記事のように「先にコピーを残してから消す」設計にしておくと、

予期しない削除事故を防げます。

くわしい自動化の開示方針は編集方針ページもご覧ください。

関連記事