Mover un archivo o directorio (file.move)

Declaración

éxito, mensaje_de_error = file.move(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 movimiento:
  • 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

Mueve el archivo o directorio de ruta_de_origen a ruta_de_destino; moverlo dentro del mismo directorio equivale a renombrarlo.
Palabras clave: renombrar o mover archivos, directorios y carpetas.
Disponible desde las versiones posteriores a 20250313.

Ejemplo

ok, err = file.move(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.