FindFileInPath()

This is an inbuilt function function provided by PPWIZARD.

The purpose of this routine is to search for a file. It gives you full control over where it searches, unlike the FindFile() routine. If you want the current directory searched then you need to specify this!

The return code is the full name of the file or the empty string ("") if it could not be located.

This routine takes 2 parameters as follows:

1. LookingFor
   This is the partial name of a file which we are trying to locate (such as "HTMLPRE.IH" or "include\HTMLPRE.IH").

2. DirList
   This is a list of items separated by ";" (or colon for unix), each being one of the following:

   • If the item begins with a "*" character then what follows is the name of an environment variable whose contents should be searched.

   • If the item begins with a "+" character then what follows is the name of a directory. You wish the whole directory tree to be searched. Note that depending on the size of the tree you could significantly slow down searching (be careful).

     If performance is an issue you may wish to use Files4Mask() once and use IncludePath() or build up a rexx variable containing a complete list of subdirectories.

   • If the items does not begin with any special character then it is simply the name of a directory to be searched. The directory may or may not already have a trailing slash.

Example

#DefineRexx '' TRACE_ON
   File1 = FindFileInPath("ppwizard.rex", "+c:\webimage;*PATH;c:\any\dir1\;*REGINA_MACROS;+c:\any\dir2tree");
#DefineRexx

email me  any feedback, additional information or corrections.
See this page online (look for updates)

PPWIZARD Manual

Saturday May 28 2022 at 2:55pm