Renames a file.

Returns:

Success returns True. Failure returns False.

Example:

ClientFileRename('MAGIC.FILE','MAGIC.SAV') result: MAGIC.FILE is renamed MAGIC.SAV

Note:

• In each parameter the string may include a path. If the path is omitted, Magic xpa assumes the current directory.

• If the rename cannot be performed (e.g., the target file is on a different drive), the file will be copied to the target drive under the new name.

• This is a client-side function that is only available for Rich Client tasks. To use the server-side version of this function in Rich Client tasks, see FileRename.

Platform specific:

• On iOS devices, only access to the temp folder is allowed. You can either use a relative path or use ClientOSEnvGet('temp') to get the folder.

• On Android devices, the file system is case sensitive. The names of Magic xpa related files, such as images and local databases are automatically saved in lower case (even if the file is defined with upper case letters). This function will not convert the file name to lower case. Therefore, if you need to refer to the destination file from Magic xpa, you should use a lower case name in the function.

See also:

ClientFileCopy, ClientFileDelete, ClientFileExist, ClientFileSize

The Rich Client Samples project (REL19b)