Lasso Programming: Lasso Language Reference

[ string->merge ]

Method

[String->Merge] modifies the string object in-place by merging or inserting another string at a specified location. This tag requires two parameters and accepts several optional parameters.

The first parameter is the location in the base string at which to insert the merge string. A 1 specifies that the merge string should be inserted before the base string.

The second parameter is the string to merge.

An optional third parameter specifies an offset into the merge string. Only characters after the specified offset will be inserted into the base string. This parameter defaults to 1.

An optional fourth parameter specifies the number of characters from the merge string that should be inserted into the base string. This parameter defaults to the length of the merge string.

No characters from the base string will be replaced. The merge string will be inserted into the base string at the specified location, but the base string will remain intact before and after the merged string.

Syntax

'String Object'->merge(Offset Integer, 'Merge String')
'String Object'->merge(Offset Integer, 'Merge String', Merge Offset Integer)
'String Object'->merge(Offset Integer, 'Merge String', Merge Offset Integer, Merge Length Integer)

Examples

Beginner

To merge one string into another:

Use the [string->merge] method. The following example modifies the string object by inserting at the eleventh position a portion of the parameter string. The portion inserted begins with the eighth character and a total of six characters to insert.

Code

local('s') = 'The quick rhino'
#s->merge(11,'purple white black', 8, 6)
#s

Result

The quick white rhino

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

Examples

To merge one string into another:

Related Entries

Related Methods

Related Types

Methods

Types

Recent Comments

Search

Your Favourites

Recently Viewed

Contributors

LassoSoft Inc. > Home