- Contents
Interaction Designer Help
Parse String RegEx
This System tool allows the parsing of a string based on a standard regular expression. This could be used to check and match IP, email, or SIP addresses within a string.
Inputs
String
The string to parse.
Expression
A string containing the regular expression with which the string is to be parsed. The regular expression uses the following escape sequences:
"\+" |
Represents the one or more repetition operator |
"\?" |
Represents the zero or one repetition operator |
"\[" and "\]" |
Used to specify character ranges (sets) |
"\{" and "\}" |
Used for bounded repetitions |
"\(" and "\)" |
Used to group sub-expressions |
"\|" |
Represents the alternation operator |
Note: To get a single slash in the actual string at runtime, you need to enter double slashes. For example, to get the string "\+" you need to enter "\\+" in the Interaction Designer editor.
The expression syntax supported in this tool is based on the Boost Library's Perl regular expression syntax, which is available online at: http://www.boost.org (Search the Documentation link for: "Perl regular expression syntax")
Case Sensitive
When this checkbox is selected, case-insensitive comparisons are used. Clear this checkbox if you do not want the comparisons to be case-sensitive.
Outputs
Result
Text string containing the results of the expression applied to the parsed string.
Exit Paths
Success
This path is taken if the string is successfully parsed.
Failure
This path is taken if the regular expression did not match the input string.