File_Move (srcPath, destPath)

Result Type:  numeric error code; 0 on success, non-zero on failure

Definition:  This function operates on closed files (it will work on open files on Mac, but not on Windows, as per those OS's conventions). The file at srcPath is renamed (moved) to destPath. Returns 0 on success or non-zero to indicate failure.

The paths must be in script-accessible ("safe") locations. Additional safe locations can be specified by the user in their application preferences.

If the destPath is blank (empty string), the function will present a Save As dialog, with which the user may choose a destination path anywhere.

Files may be moved across volumes.

Availability:  available within MWScript handlers.

See Also:

File_Close: File functions for creating/reading/writing text files

File_GetLength: File length in bytes

File_GetMark: Get current read/write position

File_Open: Open a file

File_Path: Get the full path of an open file

File_Read: Read text from current position

File_ReadLine: Read to end of line from current position

File_SetMark: Set Current read/write position

File_Write: Write text at current position

WriteToTempFile: Create a temp file containing the string