Difference between revisions of "LlListInsertList"
Jump to navigation
Jump to search
m |
m (<lsl> tag to <source>) |
||
| Line 19: | Line 19: | ||
|constants | |constants | ||
|examples= | |examples= | ||
< | <source lang="lsl2"> | ||
list numbers = [3, "three", 2, "two", 1, "one"]; | list numbers = [3, "three", 2, "two", 1, "one"]; | ||
default | default | ||
| Line 36: | Line 36: | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow|[[llDeleteSubList]]}} | |also_functions={{LSL DefineRow|[[llDeleteSubList]]}} | ||
| Line 50: | Line 50: | ||
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) | 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) | ||
< | <source lang="lsl2"> | ||
list oldList = ["B", "C", "D"]; | list oldList = ["B", "C", "D"]; | ||
list newItem = ["A"]; | list newItem = ["A"]; | ||
list newlist = newItem + oldList; | list newlist = newItem + oldList; | ||
</ | </source> | ||
|permission | |permission | ||
Latest revision as of 11:15, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: list llListInsertList( list dest, list src, integer start );| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a list that contains all the elements from dest but with the elements from src inserted at position start.
| • list | dest | |||
| • list | src | |||
| • integer | start |
start supports negative indexes.
Specification
| Index | Positive | Negative |
|---|---|---|
| First | 0
|
-length
|
| Last | length - 1
|
-1
|
Indexes
- Positive indexes count from the beginning, the first item being indexed as
0, the last as(length - 1).
- Negative indexes count from the far end, the first item being indexed as
-length, the last as-1.
Caveats
- If start is out of bounds the script continues to execute without an error message.
Examples
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
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
Deep Notes
Signature |
|---|
function list llListInsertList( list dest, list src, integer start ); |