Difference between revisions of "LlListInsertList"

Revision as of 21:38, 16 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 past the end of src, then dest is appended to src, it will not add null entries. To avoid this, create empty elements in the list first. A similar outcome occurs when using negative indexes.

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=*If '''start''' is past the end of '''src''', then '''dest''' is appended to th end of '''src''', 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}}.
+|caveats=*If '''start''' is past the end of '''src''', then '''dest''' is appended to '''src''', 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}}.
 |constants
 |examples