メインコンテンツまでスキップ

ファイルまたはディレクトリをコピー (file.copy)

宣言​

成否, エラー情報 = file.copy(コピー元パス, コピー先パス [, モード])

パラメータ​

  • コピー元パス
    文字列型、ファイルの絶対パス
  • コピー先パス
    文字列型、ファイルの絶対パス
  • モード 20250914+
    文字列型のオプションパラメータ。コピーモード。指定できる値：
    • 空文字列または省略：デフォルトモード（no-clobber）。コピー先がすでに存在する場合は失敗を返します
    • "overwrite" または "o"：上書きモード。既存のコピー先を直接置き換えます（既存のコピー先は削除されます）
    • "merge" または "m"：マージモード（ディレクトリのみ）。コピー先にすでに存在するファイルを保持します
    • "overwrite-merge" または "om"/"mo"：上書きマージモード。ディレクトリをマージし、同名のファイルを上書きします

戻り値​

  • 成否
    ブール型。操作に成功した場合は true、失敗した場合は false を返します
  • エラー情報
    文字列型。操作に失敗した場合のエラー情報

説明​

ファイルまたはディレクトリを コピー元パス から コピー先パス にコピーします
キーワード：ファイルのコピー、ディレクトリのコピー、フォルダのコピー
この関数は 20250313 以降のバージョンで使用できます

例​

ok, err = file.copy(XXT_SCRIPTS_PATH..'/1.zip', XXT_SCRIPTS_PATH..'/2.zip')
if not ok then
    sys.alert('拷贝失败：'..err)
end

注記：上記のコードでは、この章で扱っていない関数 sys.alert を使用しています