Difference between revisions of "LlListInsertList"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m |
m |
||
| 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 | ||
Revision as of 11:42, 13 June 2012
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: list llListInsertList( list dest, list src, integer start );| 200 | Function ID |
| 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
<lsl> 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
}
}
}
</lsl>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)
<lsl> list oldList = ["B", "C", "D"]; list newItem = ["A"]; list newlist = newItem + oldList; </lsl>
See Also
Deep Notes
Search JIRA for related Issues
Signature |
|---|
function list llListInsertList( list dest, list src, integer start ); |