FindNextRegExList

Syntax

bool FindNextRegExList (StrParam)

Parameters

The name of the Keyword text file. The file will contain a list of words or phrases, separated by new lines, that will be used for matching.

Returns

True if at least one word on the page, that follows the result of a previous find, matches any word or pattern in the Keyword file. Otherwise, False.

Level

Field level only.

Details

Opens the Keyword file you specify as a parameter, starting from the location of a previous find, this action checks the words or phrases on the current page against the keywords in the list to find a match. The entries in the keyword file are expected to be regular expressions.

To perform the action, the search first looks for the first word or phrase in the keyword file. Starting from the location of the last find, if the word is found, the search stops. If no match is found, the next line from the keyword file is read and again the search starts from the result of a previous find. This process continues until a match is found or all of the lines in the keyword file have been read. The location of the found word or phrase that matches an entry in the keyword file will be remembered so the result can be used by subsequent actions. Word matching is case sensitive.

Example

FindRegExList("InvoiceNum")
FindNextRegExList("InvoiceNum")

This action searches the current page, starting from the result of the FindRegExList action, for the first keyword in the Keyword file (InvoiceNum.key). If successful, the search stops and remembers the location of that word for subsequent actions; if not, the action continues searching for the next word in InvoiceNum.key, repeating this search pattern until a match is found, or until there are no more keywords. Although this example shows FindNextRegExList using the same keyword file, it is allowed to use a different keyword file.