Add

add( tbl, v, [i]  )

Adds a element to the end of a sequence in a table.

tbl

The table.

v

The value to add.

i

The index for the value to be inserted.

The add() function appends an element to the end of a sequence in a table.

This always adds the new element immediately after the current final index. It does not check for available gaps between the start and the end.

The add() function returns the object being added. You can ignore this return value, or pass it back to your own caller.

Examples

t = {1, 5}
add(t, 7)  -- t = {1, 5, 7}
add(t, 9)  -- t = {1, 5, 7, 9}
add(t, 3, 2)  -- t = {1, 3, 5, 7, 9}