FileOps.$rename()

Function group Execute on client Platform(s)
FileOps NO All

Syntax

FileOps.$rename(cOldname,cNewname)

Description

Renames the file or folder named cOldname to cNewname.

The function returns an error code, or zero if successful: see the FileOps function error codes.

Example

Do  FileOps.$rename('c:\omnis\libs','c:\omnis\examples') Returns lError
# renames the 'libs' folder to 'examples'

Do FileOps.$changeworkingdir('c:\omnis\datafile\odbc') Returns lError
Do FileOps.$rename('odbc.txt','readme.txt'Returns lError
# switches to the 'c:\omnis\datafile\odbc' folder and renames 'odbc.txt' to 'readme.txt'