Test path name
Test path name ( pathname ) : Integer
| Parameter | Type | Description | |
|---|---|---|---|
| pathname | Text | → | Pathname to directory, folder or document |
| Function result | Integer | ← | 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 constants are provided by 4D:
| Constant | Type | Value |
|---|---|---|
| Is a document | Integer | 1 |
| Is a folder | 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
Convert path system to POSIX
Create document
CREATE FOLDER
Object to path
Path to object
Properties
| Command number | 476 |
| Thread safe | ✓ |