Lasso Soft Inc. > Home

[ String_ReplaceRegExp ]


[String_ReplaceRegExp] takes three parameters: a string value, a -Find keyword/value parameter, and a -Replace keyword/value parameter. Returns a string with each instance of the -Find regular expression replaced by the value of the -Replace regular expression within the string parameter.

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.

In the replacement pattern the following additional symbols can be used.

\\1 ... \\9 - An escaped number substitutes in the specified group (defined by parentheses) from the source.

  • Syntax
string_replaceregexp(String Value,
	-find=Regular Expression,
	-replace=Regular Expression);

string_replaceregexp(String Value,
	-find=Regular Expression,
	-replace=Regular Expression,
string_replaceregexp(String Value,
	-find=Regular Expression,
	-replace=Regular Expression,
  • Beginner

To replace an email address with a mailto link:

Use the [String_ReplaceRegExp] method. The following example replaces any email address in the source with an HTML anchor tag that allows visitors to send email to the address.


string_replaceregexp('Send email to [email protected]',
	-replace='<a href=\"mailto:\\1\">\\1</a>')


Send email to [email protected]
  • Tips

Use the Regular Expression Utility to write Lasso code with proper escaping automatically.

The following websites are resources for regular expressions.

Recent Comments

No Comments found

Please note that periodically LassoSoft will go through the notes and may incorporate information from them into the documentation. Any submission here gives LassoSoft a non-exclusive license and will be made available in various formats to the Lasso community.

LassoSoft Inc. > Home



©LassoSoft Inc 2015 | Web Development by Treefrog Inc | PrivacyLegal terms and Shipping | Contact LassoSoft