DIREXISTS: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
No edit summary
m (Fix typo)
 
(2 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: [[Windows Libraries#Disk Drives|Disk Drives]]
* '''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}}
{{Parameter|Example:'' Checks if a folder exists before proceeding.
''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



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link