Difference between revisions of "Category:LSL String"

Latest revision as of 09:44, 29 October 2023

LSL Portal

Variable: string name;

string name;

Declares a variable of type string named name, with the value ""

• variable

name

–

variable name

Variable: string name = value;

string name = value;

Declares a variable of type string named name, with the value value.

• variable	name	–	variable name
• expression	value	–	string expression or constant

Typecast: (string)value

(string)value

Converts value to a value of type string.

• expression

value

–

expression or constant

Operators

See Operators for more information.

Combine: value1 + value2

(value1 + value2)

Combines two strings into a single string without modifying the inputs. Appends value2 to value1 and returns the resulting string.

• expression	value1	–	string expression or constant
• expression	value2	–	string expression or constant

Comparison: value1 == value2

(value1 == value2)

Compares two strings, returns one if same length and same characters, else returns zero. This operator works exactly like !strcmp(value1, value2) in C, thus technically differs from the counterintuitive behavior of the == operator in C and in Java.

• expression	value1	–	string expression or constant
• expression	value2	–	string expression or constant

Comparison: value1 != value2

(value1 != value2)

Compares two strings, returns zero if same length and same characters, otherwise non-zero. This operator works exactly like strcmp(value1, value2) in C, thus technically differs from the counterintuitive behavior of the != operator in C and in Java.

• expression	value1	–	string expression or constant
• expression	value2	–	string expression or constant

Escape Codes


Substring	Replaced with
\t	four spaces
\n	new line
\"	double quote
\\	backslash

Escape codes are translated when the script is compiled; not while it's running. The compiler will ignore any other combination of \ with a character by removing the \. So "\a" means "a". The result is that only strings that are inside your script when it is compiled will get, say, \n turned into a "new line" character. Text you read in from a notecard, chat, http, object name or description, etc, will not be checked for escape codes -- that same \n typed in a notecard doesn't automatically turn into a "new line" character. You'll have to do that yourself, if you really really need it for some reason.

Those who are coming to LSL from such languages as C and Java may find these LSL string escape rules confusing at first. In LSL, "\n" means llUnescapeURL("%0A"), as it does in C and Java, but "\t" means llUnescapeURL("%20%20%20%20") rather than llUnescapeURL("%09"). Additionally there is no "\r" escape code and "\r" will translate to "r" rather than llUnescapeURL("%0D").

For runtime translation of escaped characters try the user function Unescape.

Characters with Accents

It used to be that your script would not compile if you included in it a string containing a character with an accent, such as "écoutez", or punctuation not used in English, such as "¿Entiende?".

Sometime in late spring / early summer 2008, scripts began compiling with accents in text strings.

That is to say:

string hello = "Avatar écoutez";

String Length Restraints

As noted at the start of this page, the length of a single string is only limited by available script memory. However, there are some operational limitations. Many Communications functions and some other functions also impose limits on input strings. Those limits may result in error messages at runtime or "silent" truncation (i.e. you get no error notice, nor any indication that it has been done.).

Examples

llSay - When using llSay, any text string being said will be truncated to 1024 CHARACTERS, both under LSO and Mono. (That's 2048 bytes of memory space in Mono (UTF-16) ).
llGetNotecardLine - When reading in lines from notecards, lines longer than 1023 characters will be truncated silently. (Limit was formerly 255, however with SLS 565008 this has been increased.)
llDialog - If the message or button texts are too long a non-fatal error is produced when the function is called.

Notes
Limits of this type are always documented, an absence of limits in the documentation means there are no known limits (that are outside the norm for the language).

Trimming a String

Trimming a string used to require user-created functions, such as those created for the purpose in Strife Onizuka's library.

Now, however, there is a native LSL function, llStringTrim, which can be used to remove leading and/or trailing spaces. Note though that it does not remove excess spaces that a user may have entered in the middle of a sentence or string, nor is there any other native LSL function which does.

The following code will remove both all double spaces inside a string, as well as any leading and trailing spaces; it will how ever require a substantial amount of memory overhead.

string myTrimmedText = llDumpList2String(llParseString2List(src, [" "], []), " ");

When accepting user text input from chat, a notecard, or a prim name or description, or any other "free-wheeling" source, it's a good idea to always llStringTrim first before beginning to work with it.

Examples

integer int = 48934;
string str = (string)int;
string str_2;
str_2 = str;

Useful Functions

User-created utility functions

These functions have been created and contributed by LSL users to perform operations not covered by built-in LSL functions.


function	purpose
Chr	~~Returns the Unicode character with the given code. See also Ord.~~ Built-in function: llChar.
Float2String	Allows string output of a float in a tidy text format, with optional rounding.
Left	Returns text left of a specified separator.
Like	See if one word matches part of another.
Ord	~~Returns the ordinal (Unicode code) of a character. See also Chr.~~ Built-in function: llOrd.
RandomString	Creates a random string.
RemoveHTMLTags	Removes HTML tags from a string ( and newline characters )
Right	Returns text right of a specified separator.
str_replace	~~Replace all instances of a string with another string in a target string.~~ Built-in function: LlReplaceSubString.
Stristr	Returns a string from the first occurrence of needle to the end of haystack.
SplitLine	Insert 'new line' escape codes at certain positions of a string.
WrapText	Break text into line lengths of your specification.

Text-Related Items from the Script Library

Name	Creator	Description
ParseString2List	Strife Onizuka	Same as llParseString2List and llParseStringKeepNulls, but not limited to 8 spacers or separators. Thus substitute a call to the llParseString2List and llParseStringKeepNulls functions by a call to ParseString2List whenever you have more than 8 separators or more than 8 spacers.
String Compare	Xaviar Czervik	Compares two strings and reliably returns either 1, -1, or 0 if they are the same.
XyText	Xylor Baysklef	Display text (up to 10 characters) on a prim. Use as many prims as desired.
XyyyyzText	Criz Collins	Display text (up to 10 characters) on a prim. Displays different text for each line instead of one single text, that will be broken into the next lines. Watch here for what that means: http://screencast.com/t/1wMLujLcEO
XyzzyText	Thraxis Epsilon and Gigs Taggart	Display text (up to 10 characters) on a prim. Way more efficient than XyText.

Subcategories

This category has the following 2 subcategories, out of 2 total.

L

LSL Hash

S

LSL Functions/Returns a string

Pages in category "LSL String"

The following 46 pages are in this category, out of 46 total.