Find files

The Find files mode may be used to search for specified strings in files.  These may be located on the local system or in files specified to be opened from FTP paths.  Paths to be searched may be specified by any of the following methods:

If the Search subdirectories option is not selected, the search will be limited to the top level of the specified search folder(s).  If Ignore hidden subdirectories is selected, any hidden folders in the target folder(s) will be skipped during the search.

The string to search for is specified in the Find what field.  A single or multi-line string up to 20,000 bytes may be used.  The files to search are specified in the In files/types and the search target list.  The search target list specifies the files/folders to search and the In files/types field specifies the filename or types.  The filename may contain wildcards and may also contain multiple file types separated by semicolons, i.e.:

*. cpp;*.h

Users may choose to search for files based on the contents of the file or the name of the file.  If the File contents radio button is selected, the contents of all files matching the specified parameters will be parsed to see if the string specified in the Find what field occurs in the file.  If the File name radio button is selected, the names of all files matching the specified search string will be listed in the Output Window.  

Users may specify subdirectories to ignore in a search using the Ignore subdirectories field if desired.  Multiple items may be defined and should be separated with a semicolon, i.e.:

backup;cvs;tmp;var;

Users may also specify file names/extensions to ignore in a search using the Ignore files/types field if desired.  Multiple items may be defined and should be separated with a semicolon, i.e.:

auth*;*.sql;*.log;

Pressing the Start button will execute a search using the currently defined search parameters.  When a search is in progress, the Start button changes to a Pause button, which the user may press to temporarily suspend a search if necessary.  If desired, the user may press the Cancel button to completely halt a search.  When the find is executed, any existing output is cleared.  

If the button is pressed the find history is displayed.

If the button is pressed a submenu with the following options are presented:

If the button is pressed a list of regular expression options appropriate to the selected Regular expressions option is displayed.  This button is subdued unless the Regular expressions checkbox is selected.

The following search options are supported:

Regular expressions

Perl

If this option is selected the application will use Perl style regular expressions based on the Boost C++ Libraries.

UltraEdit

If this option is selected the application will use UltraEdit style regular expressions.

Unix

If this option is selected the application will use Unix style regular expressions.

For information regarding creation of regular expressions see the Regular expressions help topic.

Match whole word

By default, the search will not be restricted to matching whole words only. This option allows the search to be restricted to whole words only. This is useful for searching for 'a', or 'A' without finding all words including 'a'. If a search has already occurred in a document, the default selection will match the previous search.

Match case

By default, the search will not be case sensitive. The option to make the search case sensitive is given.  This option also affects regular expressions.  If this is not checked, [A-Za-z] and [A-Z] are equal to [a-z].

Find not-matching lines

This option instructs UltraFinder to list each individual line that does not match the search parameters.  Whereas Match if string not found only lists files that do not include the specified search string, this option returns data on a line-by-line basis.

Match if string not found

This option instructs UltraFinder to list only files that DO NOT include the specified search string.

Use file index

When the File name radio button is selected, the Use file index option is active.  If this is selected, UltraFinder will use Windows Search indexing to identify matching items.  If this is not selected, UltraFinder will parse the directory system to search for matching items itself.  Users may control which folders are indexed by modifying Indexing Options in the Windows Control Panel.

Use encoding

By default this option is disabled.  When the checkbox is selected, the dropdown may be used to specify the encoding to be used when searching for the specified string.