Skip to content
lsl.devlsl.devLSL Dev

llListInsertList

View as MarkdownThis page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page
function
Function syntax
list llListInsertList(
  1. list dest,// Target destination list.
  2. list src,// Source list to insert.
  3. integer start// Zero-based index where insertion begins.
);
Returns
list
Energy
10

Returns a new list containing all elements of dest with the elements of src inserted starting at index start. Does not modify dest itself.

Returns a list that contains all the elements from dest but with the elements from src inserted at position start.

How to use
list result = llListInsertList([], [], 0);

Examples

Section titled “Examples”
Example 1
8 collapsed lines
list numbers = [3, "three", 2, "two", 1, "one"];
default
{
    state_entry()
    {
        llOwnerSay(llDumpList2String(numbers, ","));
        // Object: 3,three,2,two,1,one
        integer index = llListFindList(numbers, [2]);
        if (index != -1)
        {
            numbers = llListInsertList(numbers, [2.5, "two and a half"], index);
            llOwnerSay(llDumpList2String(numbers, ","));
            // Object: 3,three,2.500000,two and a half,2,two,1,one
        }
    }
}

Notes

Section titled “Notes”

Bear in mind that the source list will remain unchanged. Instead, a new list will be produced. So, it’s important that you capture this with a variable (unless you are acting directly on the results.)

Tip! To insert something at the start of a list, you can just add the two lists (putting the list with the new item(s) first)

list oldList = ["B", "C", "D"];
list newItem = ["A"];
list newlist = newItem + oldList;

See also

Section titled “See also”

Functions

Section titled “Functions”
Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.