Previous: base_name, Up: File Directory


8.2 searchpath

Search a set of paths for a file.

Synopsis

     #include <suplib/file.h>
     
     
     
char *searchpath( char *file, char *default_path, char *path_spec );

Parameters

char *file
the file to look for
char *default_path
the default path
char *path_spec
the list of paths

Description

searchpath scans a list of paths for a file. The paths are specified in a string, separated by the PATHSEP character (`:' for UNIX). The paths are searched in the order that they occur in the string. If an empty path is found in the specification, a user specified default path (or the current directory, should this not be specified) will be searched at that point. If the filename begins with DIRSEP (`/' for UNIX), it is used directly.

Returns

It returns a pointer to a dynamically allocated string holding the complete path, or NULL if it couldn't find the file or it ran out of memory. The calling procedure must free this string.

Author

Diab Jerius