llInsertString

From Second Life Wiki
Revision as of 13:30, 30 January 2023 by Maestro Linden (talk | contribs) (add reference to llReplaceSubString)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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 );