lfilerename

Rename a file in the same directory, ignoring any file redirections in the assignment file.

lfilerename  FilePath, NewFileName

Example: lfilerename "test.txt", "tested.txt"

Parameters

Parameters
Parameter Data Type Description
FilePath String File name, optionally preceded by the path to the file. Must not end with a directory separator.
NewFileName String New file name. Must not end with a directory separator and must not include the path to the file.

Return Values

Values returned by $procerror
Value  Error constant Meaning
0

 

Successful
-13 <UIOSERR_OS_COMMAND> An error occurred while trying to perform the OS command. Set /pri=64 to display the exact error in the message frame.

Use

Allowed in all component types.

Description

The lfilerename statement renames FilePath to NewFileName within the same directory, ignoring any file redirections in the assignment file. The file can be renamed in a ZIP archive. In other respects, lfilerename works the same as filerename. For more information, see filerename.

History
VersionChange
9.1.01Added ZIP file support

Related Topics