mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-31 10:00:16 +00:00
36 lines
1.3 KiB
Text
36 lines
1.3 KiB
Text
|
The '''KILL''' statement deletes a file on a relative path designated by a [[STRING]] value or variable.
|
||
|
|
||
|
|
||
|
|
||
|
{{PageSyntax}}
|
||
|
:: KILL filespec$
|
||
|
|
||
|
|
||
|
* Filespec is a literal or variable string path and filename. Wildcards * and ? can be used but '''be careful!'''
|
||
|
::'''*''' denotes one or more wildcard letters of a name or extension
|
||
|
::'''?''' denotes one wildcard letter of a name or extension
|
||
|
|
||
|
* Path can be relative to program's current location or use an absolute path from the root drive.
|
||
|
* KILL cannot remove an [[OPEN]] file. The program MUST [[CLOSE]] it first.
|
||
|
* If the path or file does not exist, a "File not found" or "Path not found" [[ERROR Codes|error]] will result.
|
||
|
* [[SHELL]] ''"DEL /Q " + filename$'' does the same without a prompt or verification for wildcard deletions.
|
||
|
* [[SHELL]] ''"DEL /P " + filename$'' will ask for user verification.
|
||
|
* Cannot delete folders or directories! Use [[RMDIR]] to remove empty folders only!
|
||
|
* '''Warning! Files deleted in DOS or QB64 will NOT go to the Recycle Bin and they CANNOT be restored!'''
|
||
|
|
||
|
|
||
|
|
||
|
''Example:''
|
||
|
{{CodeStart}}
|
||
|
KILL "C:\Qbasic\data\2000data.dat"
|
||
|
{{CodeEnd}}
|
||
|
|
||
|
|
||
|
''See also:''
|
||
|
* [[RMDIR]], [[FILES]], [[SHELL]], [[OPEN]]
|
||
|
* [[CHDIR]], [[MKDIR]], [[NAME]]
|
||
|
* [[_FILEEXISTS]], [[_DIREXISTS]]
|
||
|
* [[DOS]], [[Batch Files]], [[DOS#DEL|DEL]]
|
||
|
|
||
|
|
||
|
{{PageNavigation}}
|