llList2List

list llList2List(list ListVariable, integer Start, integer End)

Returns a subset of entries from ListVariable, in a range specified by the Start and End indicies (inclusive).

Using negative numbers for Start and/or End causes the index to count backwards from the length of the string, so 0, -1 would capture the entire string.

If Start is greater than End, the sub string is the exclusion of the entries.

Parameters

ListVariable (list)
Start (integer)
End (integer)

Technical Details

Return Type: list
Energy: 10

Basic List Slicing

list numbers = [1, 2, 3, 4, 5];
default
{
    state_entry()
    {
        integer index = llListFindList(numbers, [3]);
        if (index != -1)
        {
            list three_four = llList2List(numbers, index, index + 1);
            llOwnerSay(llDumpList2String(three_four, ","));
            // Object: 3,4
        }
    }
}

Handling Out-of-Order Indices

default
{
    state_entry()
    {
        //as shown below, there is no way to achieve a "wraparound" order of list elements [8,9,0,1]

        list NUMBERS = [0,1,2,3,4,5,6,7,8,9];
        list L2L;
        L2L = llList2List(NUMBERS, 8, 1); // [0,1,8,9]
        L2L = llList2List(NUMBERS, 8,-9); // [0,1,8,9]
        L2L = llList2List(NUMBERS,-2,-9); // [0,1,8,9]
        L2L = llList2List(NUMBERS,-2, 1); // [0,1,8,9]
    }
}

Notes

When Start is greater than End, the function returns the exclusion of the entries between them (instead of a wraparound). There is no built-in way to achieve a wraparound order of list elements using this function alone.

llList2List

Basic List Slicing

Handling Out-of-Order Indices

Notes

See Also