Difference between revisions of "LlListInsertList"

Revision as of 21:21, 12 April 2007

Function: list llListInsertList( list dest, list src, integer start );

Returns a list that is src inserted into dest at position start.

Index	Positive	Negative
First	`0`	`-length`
Last	`length - 1`	`-1`

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.

If start is out of bounds the script continues to execute without an error message.If start is larger than the number of elements in src, then dest is appended on the end, not where you asked it to be. To avoid this, create empty elements in the list first.

Signature
function list llListInsertList( list dest, list src, integer start );

@@ Line 6: / Line 6: @@
 |return_text=that is '''src''' inserted into '''dest''' at position '''start'''.
 |spec
-|caveats
+|caveats=If start is larger than the number of elements in src, then dest is appended on the end, not where you asked it to be.  To avoid this, create empty elements in the list first.
 |constants
 |examples