4D Doc Center : Test path name

Home

4D v14.3

Test path name


Test path name ( pathname ) -> Function result

Parameter	Type	Description
pathname	String	Pathname to directory, folder or document
Function result	Longint	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	Longint	1
Is a folder	Longint	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