Difference between revisions of "LlListInsertList"
Jump to navigation
Jump to search
(I think this rewording should make it harder to assume the function modifies the input parameters.) |
m (<lsl> tag to <source>) |
||
| (2 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{#vardefine:spec_between|If | {{LSL_Function | ||
{{LSL_Function/negative index|true|start}} | |inject-2= | ||
{{#vardefine:spec_between|If {{LSLP|start}} is past the end of {{LSLP|dest}}, then {{LSLP|src}} is appended to {{LSLP|dest}}, it will not add null entries. To avoid this, create empty elements in the list first. A similar outcome occurs when using {{LSLGC|Negative Index|negative indexes}}.}} | |||
{{LSL_Function/negative index|true|start}} | |||
|func_id=200|func_sleep=0.0|func_energy=10.0 | |func_id=200|func_sleep=0.0|func_energy=10.0 | ||
|func=llListInsertList|return_type=list|p1_type=list|p1_name=dest|p2_type=list|p2_name=src|p3_type=integer|p3_name=start | |func=llListInsertList | ||
|return_type=list | |||
|p1_type=list|p1_name=dest | |||
|p2_type=list|p2_name=src | |||
|p3_type=integer|p3_name=start | |||
|func_footnote | |func_footnote | ||
|func_desc | |func_desc | ||
|return_text=that contains all the elements from | |return_text=that contains all the elements from {{LSLP|dest}} but with the elements from {{LSLP|src}} inserted at position {{LSLP|start}}. | ||
|spec | |spec | ||
|caveats | |caveats | ||
|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 27: | Line 36: | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow|[[llDeleteSubList]]}} | |also_functions={{LSL DefineRow|[[llDeleteSubList]]}} | ||
| Line 41: | 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 ); |