Function Reference

FileMove

Moves one or more files

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

Parameters

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).

Return Value

Success: Returns 1.
Failure: Returns 0 if source cannot be moved or if dest already exists and flag=0.

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


FileMove("C:\foo.au3", "D:\mydir\bak.au3")

; Second example:
;   uses flags '1' (owerwriting) and '8' (autocreating target dir structure) together
;   moves all txt-files from temp to txtfiles and prechecks if
;   target directory structure exists, if not then automatically creates it
FileMove(@TempDir & "\*.txt", @TempDir & "\TxtFiles\", 9)