Test path name

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 6.0


Test path name (pathname) Number

ParameterTypeDescription
pathnameStringPathname to directory, folder or document
Function resultNumber1, pathname refers to an existing document
0, pathname refers to an existing directory or folder
<0, invalid pathname, OS file manager error code

Description

The Test path name function checks if a document or folder whose name or pathname you pass in pathname is present on the disk.

If a document is found, Test path name returns 1. If a folder found, Test path name returns 0.

The following predefined constant are provided by 4D:

ConstantTypeValue
Is a documentLong Integer1
Is a directoryLong Integer0

If no document nor folder is found, Test path name returns a negative value (i.e. -43 for File not found).

Example

The following tests if the document "Journal" is present in the folder of the database, then creates it if it was not found:

   If (Test path name("Journal") # Is a document)
      $vhDocRef:=Create document("Journal")
      If (OK=1)
         CLOSE DOCUMENT($vhDocRef)
      End if 
   End if 

See Also

Create document, CREATE FOLDER.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next