LlListReplaceList

Returns a list that is dest with start through end removed and src inserted at start.

start & end support negative indexes.

Mentally first translate any negative indexes into positive indexes

Positive indexes past the length (after the last index), or negative indexes past the beginning (before the first index) are valid. The effects are predictable, the entries are treated as if they were there but were removed just before output.

See negative indexes for more information.

If start is past the end of dest, then src is appended to dest, it will not add null entries. To avoid this, create empty elements in the list first. A similar outcome occurs when using negative indexes.

• Just calling the function will not update the variable. You must store it.

• Bad:	llListReplaceList(a, ["c"], 2, 2)
• Good:	a = llListReplaceList(a, ["c"], 2, 2)

 
default
{
    state_entry()
    {
        list a = ["a", "b", "e", "d"];
        list b = llListReplaceList(a, ["c"], 2, 2);//replace the range starting and ending at index 2 with ["c"] and store it into b
 
        llOwnerSay("\""+llList2CSV(a) + ""\""  ->  "\""" + llList2CSV(b)+"\"");//display the change
        //Will say: "a, b, e, d"  ->  "a, b, c, d"
    }
}
 

Functions

Articles