Lasso Programming: Lasso Language Reference

[ string->replace ]

Method

[String->Replace] modifies the string by replacing the specified find string with the replacement string. This method takes two forms.

The first form requires two parameters. The first parameter specifies the substring that should be replaced. The second parameter specifies the replacement string. By default case is not used when determining what substring to replace. An optional -Case parameter takes case sensitivity into account when making the replacement.

The second form requires one parameter. The first parameter specifies a regular expression that matches a substring to be replaced. An optional second parameter specifies the replacement string. If the second parameter is omitted, then all instances of the matched substring are removed. An optional third boolean parameter -Ignorecase specifies whether to ignore case sensitivity.

Every instance of the substring will be replaced. For more control use the [String_Replace] method or the [String_ReplaceRegExp] method.

Syntax

'String Object'->replace('String Pattern','Replacement Pattern')
'String Object'->replace('String Pattern','Replacement Pattern', -case)
'String Object'->replace('Regular Expression','Replacement Pattern')
'String Object'->replace('Regular Expression','Replacement Pattern',Boolean)

Examples

Beginner
Intermediate

To replace a found string pattern with a replacement pattern:

Use the [string->replace] method. The following example modifies the string object in-place, replacing the word "quick" with "rare", then outputs the result.

Code

local('s') = 'The quick white rhino'
#s->replace('quick','rare')
#s

Result

The rare white rhino

To replace a matched regular expression with a replacement pattern:

Use the [string->replace] method. The following example modifies the string object in-place, replacing all vowels with an underscore character, then outputs the result.

Code

local('s') = 'The quick white rhino'
#s->replace(regexp('[aieou]'),'_')
#s

Result

Th_ q__ck wh_t_ rh_n_

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->replace ]

Examples

To replace a found string pattern with a replacement pattern:

To replace a matched regular expression with a replacement pattern:

Related Entries

Related Methods

Related Types

Methods

Types

Recent Comments

Search

Your Favourites

Recently Viewed

Contributors

LassoSoft Inc. > Home