4D v16.3

Test path name

Home

 
4D v16.3
Test path name

Test path name 


 

Test path name ( pathname ) -> Function result 
Parameter Type   Description
pathname  String in Pathname to directory, folder or document
Function result  Longint in 1, pathname refers to an existing document 0, pathname refers to an existing directory or folder <0, invalid pathname, OS file manager error code

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



See also 

Convert path system to POSIX
Create document
CREATE FOLDER

 
PROPERTIES 

Product: 4D
Theme: System Documents
Number: 476

This command can be run in preemptive processes

 
HISTORY 

Created: 4D v6

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)