DIREXISTS: Difference between revisions
Jump to navigation
Jump to search
Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link
(Created page with "{{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 path value. * The function returns -1 when a path or folder exists and 0 when it does not. * The function reads the system information...") |
m (Fix typo) |
||
| (3 intermediate revisions by one other user not shown) | |||
| Line 13: | Line 13: | ||
* The function will use the appropriate Operating System path separators. [[_OS$]] can determine the operating system. | * 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.''' | * '''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: [ | * '''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}} | {{PageExamples}} | ||
''Example:'' Checks if a folder exists before proceeding. | |||
{{CodeStart}} | {{CodeStart}} | ||
{{Cl|IF}} {{Cl|_DIREXISTS}}("internal\temp") THEN | {{Cl|IF}} {{Cl|_DIREXISTS}}({{Text|<nowiki>"internal\temp"</nowiki>|#FFB100}}) {{Cl|THEN}} | ||
{{Cl|PRINT}} "Folder found." | {{Cl|PRINT}} {{Text|<nowiki>"Folder found."</nowiki>|#FFB100}} | ||
{{Cl|END IF}} | {{Cl|END IF}} | ||
{{CodeEnd | {{CodeEnd}} | ||
Latest revision as of 22:37, 2 January 2024
The _DIREXISTS function determines if a designated file path or folder exists and returns true (-1) or false (0).
Syntax
- dirExists% = _DIREXISTS(filepath$)
Description
- The filepath$ parameter can be a literal or variable 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: Disk Drives
Examples
Example: Checks if a folder exists before proceeding.
IF _DIREXISTS("internal\temp") THEN PRINT "Folder found." END IF |
See also