DIREXISTS: Difference between revisions

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).

dirExists% = _DIREXISTS(filepath$)

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

Example: Checks if a folder exists before proceeding.

IF _DIREXISTS("internal\temp") THEN
    PRINT "Folder found."
END IF

@@ Line 17: / Line 17: @@
 {{PageExamples}}
-{{Parameter|Example:'' Checks if a folder exists before proceeding.
+''Example:'' Checks if a folder exists before proceeding.
 {{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}}
-{{CodeEnd}}}}
+{{CodeEnd}}