Перейти к основному содержимому

Копирование файла или каталога (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.