ListMerge Function

Action

Merges two lists.

Syntax

ListMerge (lOrig, lMerge [, iMergePos])
Variable Description
lOrig A variable containing the list into which another list is to be merged. inout LIST.
lMerge The list to be merged into lOrig. LIST.
iMergePos Optional: The position in lOrig at which the new list is to be inserted. If omitted, lMerge is appended to lOrig. INTEGER.

Notes

  • ListMerge inserts a new list lMerge into lOrig at iMergePos. lOrig is modified by the call to ListMerge.

  • If iMergePos is less than one or greater than the number of items in the list, Silk Test Classic raises an exception.

Example

[-] LIST x = {...}
	[ ] 1
	[ ] 2
[ ] ListMerge (x, {5, 6})
[ ] Print (x) // prints {1, 2, 5, 6}
[ ] ListMerge (x, {3, 4}, 3)
[ ] Print (x) // prints {1, 2, 3, 4, 5, 6}