Lasso Programming: Lasso Language Reference

[ string ]

Type

[string] creates a new string object. String objects exist as a series of Unicode characters in the UTF-32 encoding.

Empty strings can be created by calling this method with no parameters. This is the same as using an empty string literal: '', "" or ``.

A bytes object can be converted into a string by passing it to the [string] method. By default, the bytes object is assumed to contain UTF-8 characters. An optional character encoding name (e.g. 'ISO-8859-1') can be passed as the second parameter. In this case, the bytes object will be converted to Unicode using that encoding. If an unknown or unsupported character encoding name is given, a failure will be generated.

If an existing string object is passed to the [string] method, a copy of the string is generated and returned.

Any other object can be converted into a string by passing it to the [string] method. In this case, it is equivalent to calling the ->asString() method on the given object. Objects which do not provide custom ->asString() implementations are converted using the following conventions:

Integer and decimal objects are converted to their base ten string representation
A null or void object is converted into an empty string
Boolean objects are converted into either 'true' or 'false'
Date and duration objects are formatted in the same manner as when calling their ->format() methods
Objects which contain other objects, such as arrays, maps or pairs, will, in general, output the name of the object's type, followed by a set of parentheses surrounding the comma separated list of each contained element
- Each contained element is itself converted into a string by calling the ->asString() method
Any object may provide a custom ->asString() method and so the result of converting an object into a string may vary
Any object not providing its own ->asString() method will have generated a string containing only the object's type name

Syntax
Methods
Traits

string
string('value')
string(#variable)
string(#someBytes, 'ISO-8859-1')

Has methods:

```
string->oncompare(p0::string)
```
```
string->oncompare(regexp::regexp)
```
```
string->oncompare(t::tag)
```
```
string->oncompare(b::boolean)
```
```
string->oncompare(b::bytes)
```
```
string->hash()
```
```
string->append(p0::string)
```
```
string->append(s)
```

string->private_find(p0::string, p1::integer, p2::integer, p3::integer, p4::integer, p5::boolean)

string->private_findlast(p0::string, p1::integer, p2::integer, p3::integer, p4::integer, p5::boolean)

```
string->size()
```
```
string->length()
```
```
string->chardigitvalue(p0::integer)
```

string->private_compare(p0::string, p1::integer, p2::integer, p3::integer, p4::integer, p5::boolean, p6::boolean)

string->remove(p0::integer, p1::integer)

```
string->remove()
```
```
string->remove(i::integer)
```
```
string->charname(p0::integer)
```
```
string->chartype(p0::integer)
```
```
string->decompose()
```
```
string->normalize()
```
```
string->DIGIT(p0::integer)
```
```
string->foldcase()
```
```
string->sub(p0::integer, p1::integer)
```
```
string->sub(pos::integer)
```
```
string->integer(p0::integer)
```
```
string->integer()
```

string->private_merge(p0::string, p1::integer, p2::integer)

```
string->unescape()
```
```
string->trim()
```
```
string->titlecase()
```

string->titlecase(p0::string, p1::string)

```
string->reverse()
```
```
string->getisocomment(p0::integer)
```
```
string->getnumericvalue(p0::integer)
```
```
string->totitle(p0::integer)
```
```
string->toupper(p0::integer)
```
```
string->tolower(p0::integer)
```
```
string->LOWERCASE()
```
```
string->UPPERCASE()
```
```
string->isalnum(p0::integer)
```
```
string->isalnum()
```
```
string->isalpha(p0::integer)
```
```
string->isalpha()
```
```
string->isbase(p0::integer)
```
```
string->isbase()
```
```
string->iscntrl(p0::integer)
```
```
string->iscntrl()
```
```
string->isdigit(p0::integer)
```
```
string->isdigit()
```
```
string->isxdigit(p0::integer)
```
```
string->isxdigit()
```
```
string->islower(p0::integer)
```
```
string->islower()
```
```
string->isprint(p0::integer)
```
```
string->isprint()
```
```
string->isspace(p0::integer)
```
```
string->isspace()
```
```
string->istitle(p0::integer)
```
```
string->istitle()
```
```
string->ispunct(p0::integer)
```
```
string->ispunct()
```
```
string->isgraph(p0::integer)
```
```
string->isgraph()
```
```
string->isblank(p0::integer)
```
```
string->isblank()
```
```
string->isUAlphabetic(p0::integer)
```
```
string->isUAlphabetic()
```
```
string->isULowercase(p0::integer)
```
```
string->isULowercase()
```
```
string->isupper(p0::integer)
```
```
string->isupper()
```
```
string->isUUppercase(p0::integer)
```
```
string->isUUppercase()
```
```
string->isUWhiteSpace(p0::integer)
```
```
string->isUWhiteSpace()
```
```
string->isWhitespace(p0::integer)
```
```
string->isWhitespace()
```

string->encodehtml(p0::boolean, p1::boolean)

```
string->encodehtml()
```
```
string->decodehtml()
```
```
string->encodexml()
```
```
string->decodexml()
```
```
string->encodehtmltoxml()
```

string->getpropertyvalue(p0::integer, p1::integer)

string->hasbinaryproperty(p0::integer, p1::integer)

```
string->asString()
```
```
string->+(s)
```
```
string->+(s::string)
```
```
string->*(times::integer)
```
```
string->-(n::null)
```
```
string->-(n)
```
```
string->asBytes()
```

string->find(find::string, offset::integer, length::integer, patOffset::integer, patLength::integer, case::boolean)

string->find(find::string, -offset::integer = ?, -length::integer = ?, -patOffset::integer = ?, -patLength::integer = ?, -case::boolean = ?)

string->find(find::string, offset::integer, -case::boolean = ?)

string->find(find::string, offset::integer, length::integer)

string->findlast(find::string, offset::integer = ?, -length::integer = ?, -patOffset::integer = ?, -patLength::integer = ?, -case::boolean = ?)

string->contains(find, -case::boolean = ?)

string->contains(find::regexp, -ignorecase::boolean = ?)

```
string->get(position::integer)
```

string->beginsWith(find, case::boolean = ?)

```
string->beginsWith(find::string)
```

string->endsWith(find, case::boolean = ?)

```
string->endsWith(find::string)
```
```
string->equals(find, case::boolean = ?)
```

string->compare(find::string, offset::integer, length::integer = ?, patOffset::integer = ?, patLength::integer = ?, -case::boolean = ?)

string->compare(find::string, -case::boolean = ?)

string->compareCodePointOrder(find::string, offset::integer = ?, length::integer = ?, patOffset::integer = ?, patLength::integer = ?, -case::boolean = ?)

string->padLeading(tosize::integer, with::string = ?)

string->padTrailing(tosize::integer, with::string = ?)

string->merge(where::integer, what::string, offset::integer = ?, length::integer = ?)

```
string->split(find::string)
```
```
string->removeleading(find::string)
```
```
string->removeleading(find::regexp)
```
```
string->removetrailing(find::string)
```

string->replace(find::string, replace::string, -case::boolean = ?)

string->replace(find::regexp, replace = ?, ignorecase = ?)

```
string->values()
```
```
string->forEachCharacter()
```
```
string->forEachLineBreak()
```
```
string->forEachWordBreak()
```
```
string->eachWordBreak()::trait_forEach
```
```
string->eachCharacter()::trait_forEach
```
```
string->forEachMatch(exp::regexp)
```
```
string->forEachMatch(exp::string)
```
```
string->eachMatch(exp::regexp)
```
```
string->eachMatch(exp::string)
```
```
string->encodeSQL92()::string
```
```
string->encodeSQL()::string
```
```
string->keys()::trait_forEach
```

string->substring(start::integer, end::integer)

```
string->substring(start::integer)
```

Examples

Beginner

To convert an integer into a string:

Use the [string] method. The following example performs a string operation on a set of numbers by converting them to string values before applying the concatenation symbol (+) to the results.

Code

string(1) + string(1)

Result

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 ]

Has methods:

Has traits:

Examples

To convert an integer into a string:

Related Entries

Related Methods

Related Types

Methods

Types

Recent Comments

Search

Your Favourites

Recently Viewed

Contributors

LassoSoft Inc. > Home