拷貝檔案或目錄 (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