llInsertString

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

InsertString

llInsertString

Summary

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

0.0	Forced Delay
10.0	Energy

Returns a 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

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

Useful Snippets

This function will allow you to use a negative number as the position: <lsl>string insertString(string destination, integer position, string str) {

   if (position < 0)
       if ((position += llStringLength(destination)) < 0)
           position = 0;
   return llInsertString(destination, position, str);

}</lsl>

See Also

Functions

•	llDeleteSubString
•	llGetSubString

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