The Search Files command searches through multiple files. A new Search Results output window is created. Each time Source Insight finds a matching line in a file, it appends an entry to the Search Results. Each line in the Search Results file can have source links that link the line with the location of the matching text in another file.
Search
Click this button to begin the searching in the selected files, or the file named in the File Name text box.
Select All
Click to select all the files in the file list.
Browse
Click this button to show the Open File dialog box, so that you can browse your disks to locate a file to be searched. When you select a file in the Open File dialog box, its full path will be placed in the File Name text box.
Find
Type the pattern to be found in this text box. The pattern can be a regular expression.
File Name
The name of the file to search. You may also add a series of wildcard specifications and click the Search button and Source Insight will replace the file list with the results of the wildcard expansion. If the Project Wide option is on, the wildcards are expanded over the whole list of files in the current project; otherwise, the wildcards are expanded in the current directory.
If the Project Wide option is on, Source Insight will search the project symbol for file names added in the File Name text box, so you don't have to include a directory specification for those files.
File list
If the Project Wide option is on, then this list displays all files in the current project.
If the Project Wide option is off, then this list displays all the files in the current working directory. The current directory path is displayed above the file list. Source Insight shows only files for known file types in the current directory. The file types are specified with the File Type Options command.
Show Dirs
Click this button to toggle the file list contents between showing file names, and showing only subdirectory names. When the subdirectories are shown, this button changes to "Show Files".
Options Group
Project Wide
This check box controls whether the File list shows all the files in the project, or just the files in the current working directory.
Include Subdirectories
If this check box is checked, then any selected directories are recursively searched. This option and the Project Wide option are mutually exclusive.
To recursively search a set of directories:
1.Uncheck the Project Wide check box.
2.Check the Include Subdirectories check box.
3.Select one or more directories in the file list.
You can also type a file wildcard specification in the File Name text box to limit the search to particular file extensions or names.
Case Sensitive
If enabled, Source Insight will only find matches if the case matches exactly.
Use Regular Expressions
If enabled, the Find pattern is assumed a regular expression. See: Regular Expressions.
Find Non-Matching
If enabled, Source Insight will find all lines where the pattern did not match.
Whole Words Only
If enabled, then Source Insight only finds matches that are whole words. If not enabled, then Source Insight will also find matches that are embedded in words.
Skip Inactive Code
If enabled, then only code that is active under conditional compilation is searched. You must first specify known conditions in the Preferences: Languages dialog box, in order for Source Insight to know what conditions are active or not. Conditional compilation only applies to some languages.
Skip Comments
If enabled, then comments will not be searched.
Search Only Comments
If enabled, then only comments will be searched. This is mutually exclusive with the Skip Comments option. The comment options slow the search down a little.
Search Results
These options affect what appears in the Search Results after the search is completed.
Include in Results...
Click this button to specify what information is included in the Search Results.
If you add file name wildcards into the File Name text box and click the Search button, the wildcard list will be expanded, and all the files in the file list will be selected automatically. If the Project Wide check box is on, then the wildcards will be expanded over all files in the project.
So, for example, if you wanted to search all .h files in your project, you would add *.h into the File Name text box, press Enter to click the Search button, and click the Search button again to search all the files in the file list. If the Project Wide option is on, Source Insight will fill the file list with all .h files in the project, regardless of what directory they are in.