mirror of
https://github.com/QB64-Phoenix-Edition/QB64pe.git
synced 2024-06-29 10:30:36 +00:00
35 lines
1.2 KiB
Plaintext
35 lines
1.2 KiB
Plaintext
{{DISPLAYTITLE:_DIREXISTS}}
|
|
The [[_DIREXISTS]] function determines if a designated file path or folder exists and returns true (-1) or false (0).
|
|
|
|
|
|
{{PageSyntax}}
|
|
: {{Parameter|dirExists%}} = [[_DIREXISTS]]({{Parameter|filepath$}})
|
|
|
|
|
|
{{PageDescription}}
|
|
* The {{Parameter|filepath$}} parameter can be a literal or variable [[STRING|string]] path value.
|
|
* The function returns -1 when a path or folder exists and 0 when it does not.
|
|
* The function reads the system information directly without using a [[SHELL]] procedure.
|
|
* The function will use the appropriate Operating System path separators. [[_OS$]] can determine the operating system.
|
|
* '''This function does not guarantee that a path can be accessed, only that it exists.'''
|
|
* '''NOTE: Checking if a folder exists in a CD drive may cause the tray to open automatically to request a disk when empty.''' To find drives in Windows, use this API Library: [[Windows Libraries#Disk Drives|Disk Drives]]
|
|
|
|
|
|
{{PageExamples}}
|
|
{{Parameter|Example:'' Checks if a folder exists before proceeding.
|
|
{{CodeStart}}
|
|
{{Cl|IF}} {{Cl|_DIREXISTS}}("internal\temp") THEN
|
|
{{Cl|PRINT}} "Folder found."
|
|
{{Cl|END IF}}
|
|
{{CodeEnd}}}}
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_FILEEXISTS]]
|
|
* [[SHELL]]
|
|
* [[_OS$]]
|
|
|
|
|
|
{{PageNavigation}}
|
|
<
|