Aide:FileMove.txt

Document original V3.3.6.1 :

###Function###
FileMove

###Description###
Moves one or more files

###Syntax###
FileMove ( "source", "dest" [, flag] )


###Parameters###
@@ParamTable@@
source
	The source path and filename of the file to move. (* wildcards are supported)
dest
	The destination path and filename of the moved file.  (* wildcards are supported)
flag
	[optional] this flag determines whether to overwrite files if they already exist:
	Can be a combination of the following:
	 0 = (default) do not overwrite existing files
	 1 = overwrite existing files
	 8 = Create destination directory structure if it doesn't exist (See Remarks).
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns 1.
Failure:	Returns 0 if <i>source</i> cannot be moved or if <i>dest</i> already exists and flag=0.
@@End@@


###Remarks###
If the source and destination paths are on different volumes a copy and delete operation is performed rather than a move.

Because AutoIt lacks a "FileRename" function, use FileMove to rename a file!

The destination directory must already exist, except using with flag value '8'.
For instance the  combined flag '9' (1 + 8) overwrites the target file and prechecks for the destination directory structure and if it doesn't exist creates it automatically.

Some file attributes can make the overwriting impossible.

###Related###
FileCopy, FileDelete, FileRecycle, DirMove


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
FileMove

###Description###
Déplace un ou plusieurs fichiers.


###Syntax###
FileMove ( "source", "dest" [, flag] )


###Parameters###
@@ParamTable@@
source
	Chemin du/des fichier(s) à déplacer. (Les Wildcards * sont pris en charge)
dest
	Chemin et nom du répertoire de destination du/des fichier(s) déplacer. (Les Wildcards * sont pris en charge)
flag
	[optionnel] ce paramètre détermine s'il faut écraser les fichiers existants.
	Peut être une combinaison des éléments suivants :
	0 = (par défaut) n'écrase pas les fichiers existants
	1 = écrase les fichiers existants
	8 = Crée la structure du répertoire de destination, si elle n'existe pas (voir remarques).
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès:	Retourne 1.
Échec:	Retourne 0 si <i>source</i> ne peut pas être déplacé ou si <i>dest</i> existe déjà et flag=0.
@@End@@


###Remarks###
Si la source et les chemins de destination sont sur des volumes différents une copie puis une suppression est effectuée au lieu d'un déplacement.

Parce que AutoIt ne possède pas de fonction "FileRename", utiliser "FileMove" pour renommer un fichier!

Le répertoire de destination doit exister, sauf si le paramètre "8" est utilisé.
Par exemple le paramètre combiné '9' (1 + 8), écrase le fichier cible et vérifie la structure du répertoire de destination et si elle n'existe pas, il la crée automatiquement.

Certains attributs de fichier peuvent rendre l'écrasement impossible.


###Related###
<a href="FileCopy.htm">FileCopy</a>, <a href="FileDelete.htm">FileDelete</a>, <a href="FileRecycle.htm">FileRecycle</a>, <a href="DirMove.htm">DirMove</a>


###Example###
@@IncludeExample@@

Traducteur : TT22

Contributeurs (pour les modifications avant le Wiki) : Tlem