GINO Graphics Suite - GINO v9.0  

gEnqWorkingDir

Syntax

[C/C++:]
char * gEnqWorkingDir(char directory[], int slen);
[F90:]
subroutine gEnqWorkingDir(directory)
character*(*), intent(out) :: directory

Arguments

directory
Current directory

slen
Length of directory string (C/C++ only)

Description

The system utility gEnqWorkingDir() returns the current operating directory of the GINO application. This may be the directory in which the application was initiated, or one set by the routine gSetWorkingDir().

The C/C++ binding returns the directory name either in the string directory of length slen or (if directory is NULL) as a pointer to a character string that has been malloc'ed internally and which should be freed after use with the function free. In the Fortran 90 binding the directory name is returned in the character argument directory. If this is not large enough to contain the directory name it will be truncated.

Note that in a Windows environment, the directory name may be returned in the old 8.3 format if the application is run from a command prompt.

If the current working directory cannot be obtained by the system, this function will return a NUL/blank string.

See Also

gEnqWorkingDir Usage
gSetWorkingDir