Previous Next
Basic components

Retrieve button
The Retrieve button starts a query based on the entries in the Retrieve field and the Filter field. Note that you have to press this button to trigger a re-query after you change project selections in the Project Tree, or after changing selected File Types.
Queries can also be triggered either from the Info menu, or by pressing
<Return> in the Retrieve field. Filtered queries can also be triggered from the Find and Replace Filters dialog.

    Note
    Because the Retriever is independent of symbol information, it is the only SNiFF+ tool that is not updated after changes to the source code. To retrieve from modified files, you have requery.

Retrieve field
A string or a regular expression can be entered directly into the Retrieve field. The query starts when
<Return> or the Retrieve button is pressed. See also Regular Expressions in SNiFF+
Change To field
This field is used for entering modifications, that is, a replacement string which is subject to the modifications imposed by a combined regular expression filter/modifier in the Filter field.
A preview of the line as modified according to the regular expression evaluation is supplied in the Preview field. Changes only take effect after one of the modification control buttons are pressed. Note that if the Change To field is empty, and one of the modification control buttons is pressed, the matched expression is replaced by an empty string, i.e. deleted.
For details about modification control buttons, please refer to Modification control buttons.
Filter... button
The Filter... button resets the current filter and opens the Find and Replace Filters dialog. This dialog is used for creating, selecting, and maintaining regular expression filters, as well as for triggering filtered queries. See also Find and Replace Filters dialog
Filter field
You can enter regular expressions directly in this field. The string in the Retrieve field can be referenced as "
%s ". For more complex, or pre-defined, regular expressions that you might also want to save for later use, the Filter field can be filled using the Find and Replace Filters dialog. To use the dialog, press the Filter... button.
Check boxes
If you change the settings in these check-boxes, you have to press Retrieve to requery using the new settings.

Ignore Case Toggles case-sensitivity in the query.
Whole Word Toggles whether only whole words are matched.
Note that if you use an alternation, the alternatives must be grouped using
\( ...\) , e.g. \(FirstWord\|SecondWord\)
Preview Files Lists indexed files in the checkmarked projects that contain the queried string (also as a substring). The displayed file list is, however, derived from a case-insensitive, word-based index list, and all filters are ignored. The number of files where matches are actually found will thus generally be a subset of the Preview.
This check box is only enabled if the Create Index check box is selected (default) in the Preferences Retriever view.

Advanced... button
This button opens the Advanced Retriever Options dialog. The button is only enabled if the Create Index check box is selected (default) in the Preferences Retriever view.
File Types Button
Press this button to open the File Types dialog, where you can select the file types you want to query and/or make changes in. Note that you have to press the Retrieve button to re-query again after changing the file types selection.
Not all file types are selected in the dialog by default. It doesn't make sense, for example, to include image files in text-based queries. The fewer file types you select, the quicker the retrieval.
By default, the following file types are not selected: Image, Object, Makefiles, Generated, Project Description (PDF) and Documentation.
Project Tree
Changing the Project Tree settings affects only subsequent (re-)queries.
The settings in the Project Tree determine the scope of the search (exception: Search All Indexed Files). Only those files that are part of checkmarked projects are queried. The check boxes can be manipulated directly with the mouse or by using the right-click context menu.

Previous Next