LassoScript Utility
Basics Browse Detail

[String_FindRegExp]

Tag Link [String_FindRegExp] Category String
Type Substitution Source Available No
Support Preferred Version 5.0
Change Unchanged Data Source Any
Output Type Array Security None
Implementation LCAPI Sets Lasso 8.5, Lasso 8.0, Lasso 7.0, Lasso 6.0, Lasso 5.0

Description

[String_FindRegExp] takes two parameters: a string value and a -Find keyword/value parameter. Returns an array with each instance of the -Find regular expression in the string parameter.

If groups are defined in the -Find expression then the output contains the entire search result followed by each of the sub-groups. If there were 2 matches of the expressions and 2 sub-groups then the array contains a total of 6 items.

The following matching symbols are available in regular expressions. Each of these symbols matches a single character. Multiple characters are matched by combining these symbols with the combination symbols in the next table.

Note - Regular expressions in Lasso require double backslashes as shown in the listing below.

a-z A-Z 0-9 - Alphanumeric characters match the specified character.
. - Period matches any single character.
^ - Circumflex matches the beginning of a line.
$ - Dollar sign matches the end of a line.
\\... - A backslash escapes the next character. \\\\ represents a backslash.
[...] - Square brackets create a character class matching any character included inside.
[^...] - With a carat, any character other than those included inside is matched.
[a-z] - A range of characters can be specified.
\t - A tab character.
\r - A return character.
\n - A new-line character.
\" - A double quote.
\' - A single quote.
\\w - Matches any alphanumeric character or an underscore.
\\W - Matches any non-alphanumeric character.
\\s - Matches a whitespace character (space, tab, return, etc.).
\\S - Matches a non-whitespace character.
\\d - Matches a numeric digit.
\\D - Matches any non-numeric character.

The following combination symbols are used to combine matching symbols into complex expressions. For example a+ would match one or more a characters.

| - Alternation. Matches either the character before or the character after the symbol.
( ) - Grouping. Defines a named group for output. Nine pairs of parentheses can be defined.
* - Asterisk matches 0 or more repetitions of the preceding character.
+ - Plus sign matches 1 or more repetitions of the preceding character.
? - Question mark matches 0 or 1 repetitions of the preceding character.
{n} - Matches n repetitions of the preceding character.
{n,} - Matches at least n repetitions of the preceding character.
{n,m} - Matches at least n, but no more than m repetitions of the preceding character.

Syntax

[String_FindRegExpString Value,
  -Find=Regular Expression]

[String_FindRegExpString Value,
  -Find=Regular Expression,
  -IgnoreCase]

Parameters

Required Parameters
String Value The string which is to be checked.
-Find The regular expression which is to be searched for.
Optional Parameters
-IgnoreCase If specified, case is ignored when finding the search expression within the target string.
-Matchlimit By default Lasso uses a recursive match limit depth of 100,000. This parameter can be used to modify the match limit if Lasso reports an error when using this tag.

Examples

To find all email addresses within a string:

Use the [String_FindRegExp] tag. The following example returns an array of all email address in a string. The email addresses are returned complete, then separated into username and domain name.

[String_FindRegExp: 'Send email to lassodocumentation@omnipilot.com',
  -Find='(\\w+)@(\\w+\\.\\w+)']

(Array: (lassodocumentation@omnipilot.com), (lassodocumentation), (omnipilot.com))

Related Tags

Category Tags