FileRename

Renames files.

Syntax:

FileRename (source-list, destination)

Parameters:

(s) source-list one or more filenames, separated by a tab.

(s) destination target filename.

Returns:

(i) @TRUE if the file was renamed.

 

Use this function to rename an individual file, a group of files using wildcards, or several groups of files by separating the names with a delimiter.

Note: Unlike FileMove, you cannot make a file change its resident disk drive with FileRename.

Source-list and destination may contain * and ? wildcards.

Windows Vista/2008 and newer: This function may require an Administrator level account if dealing with files located in a protected directories: 'Program Files' and 'Windows'.

This function supports extended-length path names.

Examples:

FileRename("c:\config.sys", "c:\config.old")

FileRename("c:\temp\*.txt", "c:\temp\*.bak")
See Also:

FileCopy, FileDelete, FileExist, FileLocate, FileMove, IntControl 29