Test Info > Filter > Block

The Block filter is displayed when you choose Block in the Filter pop-up menu in the Test Info pane.

The default Block, Block Without Changes and Change filters are based on the Block filter plug-in.

This filter looks for two bits of text: one marking the start of the block you're interested in, and another marking the end. If the start text is left blank, the start of the input text is used, and similarly if the end text is left blank, the end of the input text is used.

Some filters may display fields to enter the text to look for, others may not display anything, if they are pre-configured to look for specific text.

If the start and/or end text appears more than once in the input text, you can disclose additional options. Drag to the left the small dot to the right of the fields to reveal these extra options.

These extra options enable you to choose whether to search from the start or the end of the input text, and search for a specific occurrence of the text, e.g. start from the 3rd occurrence from the end of the text. By default, the filter will find the first occurrence from the start of the input.

Note that the end text is constrained by the start text — it won't find a match for the end text before the start text.

This filter outputs the text between the start and end markers, without including them. This text can detect changes via the checkbox in the Options page of the Filter Info pane. If either marker can not be found, it results in a failure.