Filter Info
Filter KindFind plug-in
The Find plug-in is displayed when you choose Find in the Filter Kind pop-up menu in the Filter Info pane.
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.
You can choose whether your Find-based filter should result in success, and thus detect changes via the checkbox in the Options page. 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.
![[web link]](../../../shared/ext-link.png)