mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-22 07:55:07 +00:00
65 lines
No EOL
2 KiB
Text
65 lines
No EOL
2 KiB
Text
The {{KW|RMDIR}} statement deletes an empty directory using a designated path relative to the present path location.
|
|
|
|
|
|
{{PageSyntax}}
|
|
:{{KW|RMDIR}} {{Parameter|directory$}}
|
|
|
|
|
|
{{PageDescription}}
|
|
* {{Parameter|directory$}} is a relative path to the directory to delete.
|
|
* Directory path must be a literal or variable [[STRING]] value designating the folder to be deleted.
|
|
* If the directory contains files or folders, a [[ERROR Codes|file/path access error]] will occur.
|
|
* If the directory path cannot be found, a [[ERROR Codes|path not found]] error occurs.
|
|
* '''WARNING: Use this statement carefully! There is no prompt for permission to continue!'''
|
|
|
|
|
|
{{PageExamples}}
|
|
{{CodeStart}}
|
|
|
|
{{Cl|ON ERROR|ON ERROR GOTO}} ErrorHandler
|
|
DO
|
|
ERRcode = 0
|
|
{{Cl|INPUT}} "Enter path and name of directory to delete: "; directory$
|
|
IF {{Cl|LEN}}(directory$) THEN 'valid user entry or quits
|
|
{{Cl|RMDIR}} directory$ 'removes empty folder without a prompt
|
|
IF ERRcode = 0 THEN PRINT "Folder "; directory$; " removed."
|
|
END IF
|
|
LOOP UNTIL ERRcode = 0 OR LEN(directory$) = 0
|
|
{{Cl|SYSTEM}}
|
|
|
|
|
|
ErrorHandler:
|
|
ERRcode = {{Cl|ERR}} 'get error code returned
|
|
{{Cl|SELECT CASE}} ERRcode
|
|
{{Cl|CASE}} 75
|
|
{{Cl|PRINT}} directory$ + " is not empty!"
|
|
{{Cl|CASE}} 76
|
|
{{Cl|PRINT}} directory$ + " does not exist!"
|
|
{{Cl|CASE ELSE}}
|
|
{{Cl|PRINT}} "Error"; ERRcode; "attempting to delete " + directory$
|
|
{{Cl|END SELECT}}
|
|
{{Cl|PRINT}}
|
|
{{Cl|RESUME|RESUME NEXT}}
|
|
|
|
{{CodeEnd}}
|
|
|
|
: This Windows-specific output from two runs of the above program is typical, though your output may vary. User-entered text is in italics.
|
|
|
|
{{OutputStart}}
|
|
|
|
Enter path and name of directory to delete: ''Some\Folder\That\Doesnt\Exist''
|
|
Some\folder\That\Doesnt\Exist does not exist!
|
|
|
|
Enter path and name of directory to delete: ''C:\temp''
|
|
C:\temp is not empty!
|
|
|
|
{{OutputEnd}}
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[MKDIR]], [[CHDIR]]
|
|
* [[KILL]], [[FILES]]
|
|
* [[DOS]], [[Batch Files]]
|
|
|
|
|
|
{{PageNavigation}} |