Skip to main content

List.InsertRange

Inserts values into a list at the given index.

Syntax

List.InsertRange(
list as list,
index as number,
values as list
) as list

Remarks

Returns a new list produced by inserting the values in values into list at index. The first position in the list is at index 0.

  • list: The target list where values are to be inserted.
  • index: The index of the target list(list) where the values are to be inserted. The first position in the list is at index 0.
  • values: The list of values which are to be inserted into list.

Examples

Example #1

Insert the list ({3, 4}) into the target list ({1, 2, 5}) at index 2.

List.InsertRange({1, 2, 5}, 2, {3, 4})

Result:

{
1,
2,
3,
4,
5
}

Example #2

Insert a list with a nested list ({1, {1.1, 1.2}}) into a target list ({2, 3, 4}) at index 0.

List.InsertRange({2, 3, 4}, 0, {1, {1.1, 1.2}})

Result:

{
1,
{
1.1,
1.2
},
2,
3,
4
}

Category

List.Selection