Insert function

Insert new elements into a data field


Description

The Insert function inserts new elements at the specified index into a list or table.


Lists

A single value or a list can be inserted into a one-dimensional list.


Tables

In a two-dimensional field (table) a list or a table can be inserted.

  • A list is inserted into the table as a new line at the specified position
  • The length of the list is adjusted, if necessary, to the number of columns in the table
  • For adjustment either elements with the value zero are added or elements are cut off

A table can only be inserted into a table if the number of columns is identical.


Syntax

Insert (field, index, element)


Examples


 Insert the number 42 at the 3rd position in x


The list y is inserted at 2nd position in x


Insert line x in 2nd position in z


Insert table z at the 3rd position in z