llInsertString

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

InsertString

llInsertString

Summary

Function: string llInsertString( string dst, integer pos, string src );

0.0	Forced Delay
10.0	Energy

Returns the string dst with src inserted starting at pos.

• string	dst	–	destination of insertion
• integer	pos	–	position index for insert, first is 0
• string	src	–	source string to be inserted

pos does not support negative indexes. i.e. unlike other somewhat similar string functions such as llGetSubString and llDeleteSubString, you cannot use -1 for the counting with this function. You may use instead the function provided a bit further below.

Caveats

• If pos is out of bounds the script continues to execute without an error message.

Examples

llInsertString("input", 2, "put out")// returns "input output"

Useful Snippets

This function will allow you to use a negative number as the position:

string insertString(string destination, integer position, string str) {
    if (position < 0)
        if ((position += llStringLength(destination)) < 0)
            position = 0;
    return llInsertString(destination, position, str);
}

See Also

Functions

•	llDeleteSubString
•	llGetSubString
•	llReplaceSubString

Articles

•	Examples: str_replace	–	Replace all instances of a string with another string in a target string
•	Examples: SplitLine	–	Insert 'new line' escape codes at certain positions of a string

Deep Notes

Signature
function string llInsertString( string dst, integer pos, string src );