Functions and Directives

Function CurDirectory() Foundation

Determines or changes the current directory of the process.

CurDirectory( [<cDirectory>] ) --> cPreviousDirectory
The optional parameter <cDirectory> contains the new current directory of the process. The directory can be specified using a relative or an absolute path. In an absolute path, the disk designator may be specified via a drive letter followed by a colon ("e:"), or it can be specified via server and share name ("\\servername\sharename"). In the case of a relative path, the new current directory is calculated from the directory currently set. In any case, a runtime error is raised if the specified directory does not exist.

The return value of CurDirectory() is a string containing the previous current directory. It is specified as an absolute path without a trailing backslash character ("\"). If no argument is passed to the function, it returns the current directory.


The environment function CurDirectory() determines the current directory of the process. If a directory is specified in the <cDirectory> parameter, this directory becomes the process' new current directory. CurDirectory() correctly handles relative and absolute paths, including UNC paths.

The current directory is a global setting for the process, so changing the current directory in one thread also affects all other threads. Therefore, CurDirectory() should be used with care in applications using multiple threads. In shared libraries, the function should be avoided completely.

Determining and changing the current directory

// Read current directory 
? CurDirectory()                   // result: (project directory) 

// Change current directory 
? CurDirectory("\\abraxas\store")  // result: (project directory) 
? CurDirectory("c:\tmp")           // result: "\\abraxas\store" 
? CurDirectory("sub-dir")          // result: "c:\tmp" 
? CurDirectory()                   // result: "c:\tmp\sub-dir" 
? CurDirectory( "invalid-dir" )    // result: (runtime error) 


If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.