![]() |
OpenMake Meister |
This functions searches $MyUserPath for a file by the name of $MyFile. This process is useful for searching for an executable in a PATH statement. It can also be used to find any file in any path.
If $MyUserPath is undefined, the user's default PATH operating system environment variable will be searched. On the Windows Operating System, the PATHEXT Windows Environment Variable is also used to find the file by appending the file extensions listed in the PATHEXT to the $MyFile name.
USAGE:
$FoundFile = FirstFoundInPath( $MyFile, $MyUserPath );
Note: $MyUserPath is an Openmake::SearchPath object that contains a list of specific directories to search.
RETURNS:
Fully-qualified filename, i.e, Path + Filename ( + Windows Extension).
If the filename cannot be found, the function returns a Perl Undefined String.