Lasso Programming: Lasso Language Reference

[ String_ReplaceRegExp ]

Method

[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,
	-ignorecase);
	
string_replaceregexp(String Value,
	-find=Regular Expression,
	-replace=Regular Expression,
	-replaceonlyone)

Examples

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.

Code

string_replaceregexp('Send email to lassodocumentation@lassosoft.com',
	-find='(\\w+@\\w+\\.\\w+)',
	-replace='<a href=\"mailto:\\1\">\\1</a>')

Result

Send email to lassodocumentation@lassosoft.com

Resources

Tips

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

http://reference.lassosoft.com/Reference.LassoApp?utility/regexp

The following websites are resources for regular expressions.

http://www.regular-expressions.info/

http://regexlib.com/DisplayPatterns.aspx

Related Entries

Related
Category

Related Methods

string->append

string->asBytes

string->asString

string->beginsWith

string->chardigitvalue

string->charname

string->chartype

string->compare

string->contains

string->decodehtml

string->decodexml

string->digit

string->eachCharacter

string->eachMatch

string->eachWordBreak

string->encodehtml

string->encodehtmltoxml

string->encodeSQL

string->encodeSQL92

string->encodexml

string->endsWith

string->equals

string->find

string->findlast

string->foldcase

string->forEachCharacter

string->forEachLineBreak

string->forEachMatch

string->forEachWordBreak

string->get

string->getnumericvalue

string->getpropertyvalue

string->hasbinaryproperty

string->integer

string->isalnum

string->isalpha

string->isbase

string->isblank

string->iscntrl

string->isdigit

string->isgraph

string->islower

string->isprint

string->ispunct

string->isspace

string->istitle

string->isUAlphabetic

string->isULowercase

string->isupper

string->isUUppercase

string->isUWhiteSpace

string->isWhitespace

string->isxdigit

string->keys

string->length

string->lowercase

string->merge

string->normalize

string->oncompare

string->padLeading

string->padTrailing

string->remove

string->removeleading

string->removetrailing

string->replace

string->reverse

string->size

string->split

string->sub

string->substring

string->titlecase

string->tolower

string->totitle

string->toupper

string->trim

string->unescape

string->uppercase

string->values

String_Concatenate

String_EndsWith

String_Extract

String_FindPosition

string_findregexp

String_Insert

String_IsAlpha

String_IsAlphaNumeric

String_IsDigit

String_IsHexdigit

String_IsLower

string_IsNumeric

String_IsPunctuation

String_IsSpace

String_IsUpper

String_Length

String_LowerCase

String_Remove

String_RemoveLeading

String_RemoveTrailing

string_replace

String_ReplaceRegExp

String_ToDecimal

String_ToInteger

String_UpperCase

String_ValidCharset

Related Types

string

Your Cart

LassoSoft >

LassoDocs >

LassoTalk >

[ String_ReplaceRegExp ]

Examples

To replace an email address with a mailto link:

Resources

Related Entries

Related Methods

Related Types

Methods

Types

Recent Comments

Search

Your Favourites

Recently Viewed

Contributors

LassoSoft Inc. > Home