version 6.0
Test path name (pathname) Number
Parameter | Type | Description | |
pathname | String | Pathname to directory, folder or document | |
Function result | Number | 1, 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. You can pass either a relative or absolute pathname, expressed in the syntax of the current system.
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:
Constant | Type | Value |
Is a document | Long Integer | 1 |
Is a directory | Long Integer | 0 |
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.