dirfile, findfile, isdir - miscellaneous directory functions

SYNOPSIS

char *dirfile(dir, file, path)
char *dir, *file, *path;

char *findfile(dir, file, path)
char *dir, *file, *path;

int isdir(path)
char *path;

DESCRIPTION

dirfile forms a pathname using a directory dir and a filename file and stores the output in path. Only the last element in file is used. For example, if dir is /usr/include, and file is sys/errno.h, the resulting path will be /usr/include/errno.h.

findfile checks file to see if it exists. If so, it copies file into path. Otherwise it calls dirfile to form the pathname out of dir and file.

isdir returns 1 if path exists and is a directory. It returns 0 if path exists and is not a directory. It returns -1 if couldn't find path using UNIX stat.

RETURN VALUES

dirfile and findfile return pointers to the output paths.

Return values for isdir are described above. When isdir returns -1, an error code from stat is assigned to UNIX errno.

ERRORS

dirfile and findfile do not check for errors.

See stat for errors encountered by isdir.

FILES

None

SEE ALSO

envpath, cmdform

NOTES

TeraScan application functions use dirfile to form paths of files being output to a directory. See cmdform.


Last Update: $Date: 1999/05/10 20:56:33 $