Aller au contenu principal

Déplacer un fichier ou un répertoire (file.move)

Déclaration

succès, message d’erreur = file.move(chemin source, chemin cible [, mode])

Paramètres

  • chemin source
    Chaîne, chemin absolu du fichier
  • chemin cible
    Chaîne, chemin absolu du fichier
  • mode 20250914+
    Chaîne, paramètre facultatif, mode de déplacement. Valeurs possibles :
    • chaîne vide ou omis : mode par défaut (no-clobber), renvoie un échec si la cible existe déjà
    • "overwrite" ou "o" : mode de remplacement, remplace directement la cible existante (la cible existante est supprimée)
    • "merge" ou "m" : mode de fusion (uniquement pour les répertoires), conserve les fichiers déjà présents dans la cible
    • "overwrite-merge" ou "om"/"mo" : mode de fusion avec remplacement, fusionne les répertoires mais remplace les fichiers de même nom

Valeur de retour

  • succès
    Booléen, renvoie true si l’opération réussit et false dans le cas contraire
  • message d’erreur
    Chaîne, message d’erreur en cas d’échec

Description

Déplace le fichier ou le répertoire de chemin source vers chemin cible ; le changement de nom dans le même chemin constitue un renommage
Mots-clés : renommer un fichier, renommer un répertoire, renommer un dossier, déplacer un fichier, déplacer un répertoire, déplacer un dossier
Cette fonction est disponible dans les versions postérieures à 20250313

Exemple

ok, err = file.move(XXT_SCRIPTS_PATH..'/1.zip', XXT_SCRIPTS_PATH..'/2.zip')
if not ok then
sys.alert('移动失败:'..err)
end

Remarque : le code ci-dessus utilise la fonction hors de ce chapitre sys.alert