0LASubrFileExists < Main

Tags: view all tags
---+ .FILE EXISTS

_This subroutine is called to check if a file exists in the filesystem._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;exists?&gt;                  FIELD            SHARE? Y
      PASS         &lt;pathname&gt;                 FIELD            SHARE? N
      GOSUB    --- .FILE EXISTS
      *        check for errors
      IF       --- .FILE EXISTS               NE
</pre>
---++ Description:

This subroutine is called to check if a file exists in the filesystem. Both parameters are required, the subroutine will CANCEL if they are not received.

&lt;exists?&gt; is the result, indicating if file exists or not (Required). This must be PASSed with Share "Y". Returns Y if the file exists, N if not.

&lt;pathname&gt; is pathname to test (Required).

Notes:

The subroutine tries to open the file for Read access, and if it cannot, it returns a "N". It cannot distinguish between a file that does not exist and a file it cannot open due to file permissions, both cases will return "N".

You can also use this to test if a directory exists by passing a directory name (Unix/Linux only).
---++ Comments:

_Read what other users have said about this page or add your own comments._

<br />%COMMENT%

-- Main.PeteBrower - 2011-08-12
Topic revision: r6 - 2014-07-24 - AlKalter