TeleFlow Step 0380

From TeleFlow

Parse Step
Searches through variables or text looking for the next occurrence of a character, a series of characters, or for a number. The result can be either the character position of the first character of the located occurrence, or the string found in a delimited list.

Properties

Result (not labeled in step properties. It is the first field): The variable that will be created or modified by a value returned by the parse. If a series of characters or a number is found, the character position they were found in is entered into the result variable. An entry of 0 (zero) will result if the search failed. When using the "Delimiting string..." option, the result will a string found between delimiters. e.g.: @FINDLOC.

Parse: The variable or text to search. e.g.: @LINE or 'The quick brown fox jumps over the lazy dog.'

Search for: The type of and data to search the Parse string for, as per the following choices:

• Text string: If selected, a text or variable entry must be entered in the adjoining field. The step searches for text in the "Parse" entry.
  
• Any character of: If selected, a text or variable entry must be entered in the adjoining field. The entry must be a space separated list of individual characters to search for, including * , @ # etc. The step searches for the next encountered single character in the list in the "Parse" entry.
  
• Delimiting string: If selected, a text or variable entry must be entered in the adjoining field. The entry must be a character that is used as a "field delimiter" in the "Parse" entry.
  
• Next real number: If selected, the step searches the "Parse" entry, returning the character position of the next real number, if any.
  
• Text string: if selected, a text or variable entry must be entered in the adjoining field
  
• Any character of:
  one or a list of any character to search for, including * , @ # etc
  
• Delimiting string:
  to retrieve the text between the delimeters, such as commas, other characters or even text
  
• Next real number
  

Search from: Sets where in the Parse entry to start searching for the "Search for" entry. The options are:

• Beginning of text
  
• End of text
  
• Defined position (If selected, the search will start from the character position defined. The value/position must be entered in the adjoining field.)
  

For occurrence #: This number is used to find the nth occurrence of the "Search for" value(s) in the "Parse" entry. e.g.: @OCCUR or 4.

Search forward (unchecked = backward): Sets what direction TeleFlow will use to to search through the string.

Case sensitive: Indicates whether or not a text search should match the case (I.e. lower or UPPER case) or not.

Action Steps

Fail: The fail path is followed when the Parse doesn't find what is indicated in the "Search for" field in the "Parse" entry.

Related Steps

Set Global Variable
Set Local Variable
Compare