#include <cx/DataAccess.h>char *cxParamPathnameGet ( cxParameter *src )
integer function cxParamPathnameGet( src, file ) integer src character*(*) file
If the string begins with a tilde character, then it is expanded into a home directory name according to the same rules used by C-shell. If this expansion fails (perhaps because it references the home directory of an unknown user), the tilde notation is left alone in the result. Environment variables may be used in the input string as well, again using the notation used by C-shell. They are replaced with the values of those variables. If an undefined environment variable is encountered, it is replaced by an empty string.
For example, consider the following string:
In C, the storage used by this routine for the return value is dynamically allocated. The module programmer is therefore responsible for freeing that storage when done with the contents, by using free(3E). In Fortran, the character variable file is declared by the user. Also, the returned value is the length of the string in the parameter, which may be longer than the character variable provided by the user, in which case the caller should try again to get the full file name.