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 (unless of course you are planning to act on the results straightway.)

• 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"
    }
}

To be clear, the list you are replacing in doesn't have to actually be a list of many elements. It can be a single item that you make into a single element list just by placing square brackets around it.

list TargetList = ["a", "b", "c", "z", "e"];
list InsertList = ["d"];

To act on a single element in a list, just quote its place in the list as both start and end. For instance, 0, 0 would act only on the first element in the list; 7,7 would act only on the 8th element.

For a function that will operate as llListReplaceList does, but work on strided lists, see ListStridedUpdate.

Functions

Articles