file.move

Syntax file.move (path, folder)

Params path is a legal path name of the file or folder you wish to move.

folder is the legal path name of the folder into which the file or folder in path is to be moved.

Action Moves the file or folder indicated by path into the folder indicated by folder.

Returns True if it was able to move the folder, false otherwise.

Examples file.move ("C:\\Program Files\\Frontier\\sample.txt", "C:\\Program Files\\Frontier\\Documentation\\sample.txt")

   » true


file.move ("System:Frontier 1.0a3:", "System:Old Frontiers:")

   » true

file.move ("System:System Folder:", "XP150:")

   » false

In this case use file.copy instead for cross-volume file transfers.

Errors Attempting to move a file with file.move will result in an error when the second parameter is the name of a file rather than a folder.

If it's a cross-volume move, an error results (use file.copy instead).

If the folder already has a file with the same name as the file being moved, an error results.

See Also file.copy

Discuss