FILEEXISTS: Difference between revisions

Latest revision as of 10:09, 29 March 2023

The _FILEEXISTS function determines if a designated file name exists and returns true (-1) or false (0).

theFileExists% = _FILEEXISTS(filename$)

The filename$ parameter can be a literal or variable string value that can include a path.
The function returns -1 when a file 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 file can be accessed or opened, just that it exists.

Example: Checks if a file exists before opening it.

IF _FILEEXISTS("mysettings.ini") THEN
    PRINT "Settings file found."
END IF

@@ Line 16: / Line 16: @@
 {{PageExamples}}
-{{Parameter|Example:'' Checks if a file exists before opening it.
+''Example:'' Checks if a file exists before opening it.
 {{CodeStart}}
-{{Cl|IF}} {{Cl|_FILEEXISTS}}("mysettings.ini") THEN
+{{Cl|IF}} {{Cl|_FILEEXISTS}}({{Text|<nowiki>"mysettings.ini"</nowiki>|#FFB100}}) {{Cl|THEN}}
-     {{Cl|PRINT}} "Settings file found."
+     {{Cl|PRINT}} {{Text|<nowiki>"Settings file found."</nowiki>|#FFB100}}
 {{Cl|END IF}}
-{{CodeEnd}}}}
+{{CodeEnd}}