This is an inbuilt function function provided by PPWIZARD.
The purpose of this routine is to search for a file.
The return code is the full name of the file or the empty string ("") if
it could not be located.
This routine use used internally by PPWIZARD to search for files included
with the #include command as well as other situations.
This routine takes one or two parameters as follows:
This is the partial name of a file which we are trying to locate
(such as "HTMLPRE.IH" or "include\HTMLPRE.IH").
It may also be a complete filename.
If this parameter is non-blank then if the file is not found the
routine will generate an error (normally it would return "").
If the value is "!" then a standard message is displayed otherwise
the text of this parameter is included in the error message, for example
if the file you were looking for was a dictionary file
(whatever that meant) you could pass "dictionary".
The following locations are searched in order, using FindFileInPath():
- The Current Directory
- The Main Input Files Directory
Any locations specified with the /IncludePath switch or IncludePath() routine.
- PPWIZARD_INCLUDE environment variable.
- INCLUDE environment variable.
- PPWIZARD Install Directory
If you need more information or control over where PPWIZARD
looks for the file then you should also check out the
(which is also used internally by this call).
#DefineRexx '' TRACE_ON
File1 = FindFile("htmlpre.ih");
Sunday November 05 2017 at 10:00am