FileMove | MQL4リファレンス

ローカルまたは共有フォルダーから別のフォルダーにファイルを移動します。

bool  FileMove(
   const string  src_file_name,    // File name for the move operation
   int           common_flag,      // Location
   const string  dst_file_name,    // Name of the destination file
   int           mode_flags        // Access mode
   );

パラメーター

src_file_name

[入力]移動/名前を変更するファイル名。

common_flag

[in] ファイルの場所を決定するフラグ。common_flag = FILE_COMMONの場合、ファイルはすべてのクライアント端末\ Terminal \ Common \ Filesの共有フォルダーにあります。それ以外の場合、ファイルはローカルフォルダー（common_flag = 0 ）にあります。

dst_file_name

[in]操作後のファイル名

mode_flags

[in] アクセスフラグ。パラメータには、FILE_REWRITEおよび/またはFILE_COMMONの2つのフラグのみを含めることができます。他のフラグは無視されます。ファイルが既に存在し、FILE_REWRITEフラグが指定されていない場合、ファイルは書き換えられず、関数はfalseを返します。

戻り値

失敗した場合、関数はfalseを返します。

注意

セキュリティ上の理由から、ファイルの操作はMQL4言語で厳密に制御されています。ファイル操作がMQL4手段を使用して実行されるファイルは、ファイルサンドボックスの外部に配置できません。

新しいファイルがすでに存在する場合、mode_flagsパラメーターのFILE_REWRITEフラグの可用性に応じてコピーが作成されます。

例：

//— display the window of input parameters when launching the script
#property script_show_inputs
//— input parameters
input string InpSrcName=“data.txt”;
input string InpDstName=“newdata.txt”;
input string InpSrcDirectory=“SomeFolder”;
input string InpDstDirectory=“OtherFolder”;
//+——————————————————————+
//| Script program start function                                    |
//+——————————————————————+
void OnStart()
  {
   string local=TerminalInfoString(TERMINAL_DATA_PATH);
   string common=TerminalInfoString(TERMINAL_COMMONDATA_PATH);
//— get file paths
   string src_path=InpSrcDirectory+“//”+InpSrcName;
   string dst_path=InpDstDirectory+“//”+InpDstName;
//— check if the source file exists (if not – exit)
   if(FileIsExist(src_path))
      PrintFormat(“%s file exists in the %s\\Files\\%s folder”,InpSrcName,local,InpSrcDirectory);
   else
     {
      PrintFormat(“Error, %s source file not found”,InpSrcName);
      return;
     }
//— check if the result file already exists
   if(FileIsExist(dst_path,FILE_COMMON))
     {
      PrintFormat(“%s file exists in the %s\\Files\\%s folder”,InpDstName,common,InpDstDirectory);
      //— file exists, moving should be performed with FILE_REWRITE flag
      ResetLastError();
      if(FileMove(src_path,0,dst_path,FILE_COMMON|FILE_REWRITE))
         PrintFormat(“%s file moved”,InpSrcName);
      else
         PrintFormat(“Error! Code = %d”,GetLastError());
     }
   else
     {
      PrintFormat(“%s file does not exist in the %s\\Files\\%s folder”,InpDstName,common,InpDstDirectory);
      //— the file does not exist, moving should be performed without FILE_REWRITE flag
      ResetLastError();
      if(FileMove(src_path,0,dst_path,FILE_COMMON))
         PrintFormat(“%s file moved”,InpSrcName);
      else
         PrintFormat(“Error! Code = %d”,GetLastError());
     }
//— the file is moved; let’s check it out
   if(FileIsExist(dst_path,FILE_COMMON) && !FileIsExist(src_path,0))
      Print(“Success!”);
   else
      Print(“Error!”);
  }

Leave a Reply