FSF.FarRecursiveSearch

Far Manager

previous page next page

FarRecursiveSearch

The FSF.FarRecursiveSearch function is used to find a file in a directory tree with a name matching the given mask.

void WINAPI FarRecursiveSearch(
  const char *InitDir,
  const char *Mask,
  FRSUSERFUNC UserFunc,
  DWORD Flags,
  void *Param
);

Parameters

InitDir

Name of the directory where you want to start the search. ("c:\far\plugins" for example).

Mask

File mask to search for. Starting with FAR 1.70 beta 4, all standard features of FAR masks (multiple masks, character ranges, exclude masks and so on) are supported (see File masks).

UserFunc

Pointer to a user-defined callback function of FRSUSERFUNC type that is called for every found file. This function have to return TRUE to continue the search or FALSE to stop it.

Flags

Can be a combination of the following flags (FRSMODE enumeration):

Flag	Description
FRS_RETUPDIR	When the search is stopped, the FullName parameter of the UserFunc function will contain the directory name where the file is found, instead of the name of the file.
FRS_RECUR	Recurse the directory tree while searching for the specified file.
FRS_SCANSYMLINK	The search will follow symbolic links just as if they were directories. If one of the scanned symbolic links is a "recursive" one (for example, symbolic link points to one of it's root directories) the search will continue until the maximum allowed length of the full path string will be reached.

Param

Application-defined value to be passed to the callback function specified in the UserFunc parameter.

Return value

None.

Remarks

If you want to use the data passed in the parameters of the UserFunc function after the search is complete, you must copy it to an internal variable.
In FAR versions up to and including 1.70 beta 3 the "*" Mask is to be used if you want to find all files.
In FAR versions up to and including 1.70 beta 3, when doing recursive search, the file mask given in the Mask parameter is also used to determine the directories searched. So, if you want to find a file recursively, in most cases you should pass "*" in the Mask parameter and use the callback function to stop the search when the needed file is found.
If the FRS_SCANSYMLINK flag is not set, symbolic links will not be parsed, in no dependence of FAR configuration.

previous page start next page