|
Deletes a file from the disk, and returns a Boolean (TRUE, FALSE) indicating success or failure.
|
|
Syntax:
|
ClientFileDelete(file name)
|
|
Parameters:
|
file name – An Alpha string that represents the file name. The string may contain a path. If the path is not indicated, Magic xpa assumes the current directory.
|
|
Returns:
|
Success returns TRUE; failure returns FALSE.
|
|
Example:
|
ClientFileDelete('C:\TEMP\TMPFILE.TMP') - Deletes TMPFILE.TMP from the TEMP directory on Drive C.
|
|
Note:
|
It is advisable to use this function instead of using a Shell to OS internal event.
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 FileDelete.
|
|
Exceptions:
|
This function is not supported in Web Client tasks.
|
|
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.
-
On Android devices, when executing this function on a file placed in external storage, if the application does not have permission to write in the external storage, the function returns False. To rename or delete a file in external storage, copy another file to the external storage so that the permission request will open. (Since version: 3.2b)
|
|
See also:
|
ClientFileCopy, ClientFileExist, ClientFileRename, ClientFileSize
The Rich Client Samples project (program REL15b)
|
