DELETE FOLDER

Home

4D v20.6

DELETE FOLDER


DELETE FOLDER ( folder {; deleteOption} )

Parameter	Type	Description
folder	String	Name or full path of the folder to be deleted
deleteOption	Longint	Folder deletion option

Description

The DELETE FOLDER command deletes the folder whose name or full path has been passed in folder.

By default, for security reasons, if you omit the deleteOption parameter, DELETE FOLDER only allows empty folders to be deleted. If you want the command to be able to delete non-empty folders, you must use the deleteOption parameter. In deleteOption, you can pass one of the following constants, found in the "System Documents" theme:

Constant	Type	Value	Comment
Delete only if empty	Longint	0	Deletes folder only when it is empty
Delete with contents	Longint	1	Deletes folder along with everything it contains

When Delete only if empty (0) is passed or if you omit the deleteOption parameter:
- The folder specified in the folder parameter is only deleted if it is empty; otherwise, the command does nothing and an error -47 (The file is already open, or the folder is not empty) is generated.
- If the folder specified does not exist , the error -120 (Tried to access a file by using a pathname that specifies a non existing directory) is generated.

When Delete with contents (1) is passed:
- The folder along with all of its contents are deleted.
  Warning: Even when this folder and/or its contents are locked or set to read-only, if the current user has suitable access rights, they are still deleted.
- If this folder, or any of the files it contains, cannot be deleted, deletion is aborted as soon as the first inaccessible element is detected, and an error(*) is returned. In this case, the folder may be only partially deleted. When deletion is aborted, you can use GET LAST ERROR STACK command to retrieve the name and path of the offending file.
- If the folder specified does not exist, the command does nothing and no error is returned.
  (*) under Windows: -54 (Attempt to open locked file for writing)
  under OS X: -45 (The file is locked or the pathname is not correct)

You can intercept these errors using a method installed by the ON ERR CALL command.