The Find plug-in is displayed when you choose Find in the Filter Kind pop-up menu in the Nouveau / Éditer Filtre.
This plug-in is used by the default Find Keyword, Find Regular Expression, HTML Body, and other filters.
This plug-in is as easy or powerful as you want: it supports both simple text matching and regular expression searches.
Click on the drop-down menu to reveal the power of this filter. There are six find and replace options to choose from:
Find First Occurrence | Locate the first time the entered text appears in the input text. |
Find Specific Occurrence | Locate a subsequent time the entered text appears in the input text, optionally searching from the end instead of the start. |
Find All Occurrences | Locate every time the entered text appears in the input text, and output them all, separated by a specified delimiter (comma by default). |
Find & Replace First Occurrence | Locate and replace the first time the entered text appears in the input text. |
Find & Replace Specific Occurrence | Locate and replace a subsequent time the entered text appears in the input text, optionally searching from the end instead of the start. |
Find & Replace All Occurrences | Locate and replace every time the entered text appears in the input text. |
The filter can use simple text matching, or advanced regular expressions. It can also ignore case (by default), or be case sensitive.
If using simple text matching, it supports finding
Contains
, Starts With
, Whole Words
, and Ends
With
.
For regular expression mode, it has a helpful menu of regular expression operators to help build expressions, including a dynamically-updating list of capture group markers for replacements.
The Find-based filter can result in success, and thus detect
changes via the checkbox in the Options page of the Filter Info
pane. Or it could result in a failure if the text was or wasn't found,
if desired — useful to detect text that mustn't or must be
there. This behavior is configured in the Edit Filter
view.