Copiar un archivo o directorio (file.copy)

Declaración

éxito, mensaje_de_error = file.copy(ruta_de_origen, ruta_de_destino [, modo])

Parámetros

• ruta_de_origen
  Texto; ruta absoluta del archivo.
• ruta_de_destino
  Texto; ruta absoluta del archivo.
• modo 20250914+
  Texto opcional, modo de copia:
  • cadena vacía u omitido: modo predeterminado (no-clobber); falla si el destino existe
  • "overwrite" o "o": reemplaza directamente el destino existente (el destino existente se elimina)
  • "merge" o "m": modo de fusión (solo para directorios); conserva los archivos que ya existen en el destino
  • "overwrite-merge" u "om"/"mo": fusiona directorios y reemplaza archivos con el mismo nombre

Valores devueltos

• éxito
  Booleano; devuelve true si tiene éxito y false si falla.
• mensaje_de_error
  Texto; mensaje de error cuando la operación falla.

Descripción

Copia el archivo o directorio de ruta_de_origen a ruta_de_destino.
Palabras clave: copiar archivos, directorios o carpetas.
Disponible desde las versiones posteriores a 20250313.

Ejemplo

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

Nota: el código anterior usa la función de otro capítulo sys.alert.