Help files

Parse Text Action

Description:

This Action parses a text to find the first or all occurrences of a specified subtext or a regular expression pattern.

parsetext.png
Properties:

Text to Parse:

Enter the text, or a previously stored text Variable, to be parsed.

Text to Find:

Enter the subtext, a previously stored text Variable, or a Regular Expression, to search for.

Is Regular Expression:

Check this box if your subtext is a Regular Expression. A Regular Expression creates a range of possibilities to be the subtext. For example, \d means that the subtext could be any digit.

Start Parsing at Position:

Enter the position where this action will begin to look for the Text to Find. The first position is zero, so use 0 to start from the beginning.

First Occurrence Only:

Choose if you want this action to find the first occurrence only, or each occurrence of the Text to Find.

Ignore Case:

Choose whether you want this action to find the specified text using case-sensitive or case-insensitive matching.

Store Position(s) of found text into:

Enter a name to be the variable that will store the position(s) of the "Text to Find" into the "Text to Parse". If you have not checked Find First Occurrence, the result(s) will be a list of numerical values; otherwise, it will be a single numerical value. If the text you are searching for is not found within the original text, this variable will hold the value -1.

Store Match(es) into:

Enter the name of the Variable that will store the result(s) that match your Regular Expression. If you have not checked Find First Occurrence, the result(s) will be a list of text values; otherwise it will be a single text value.