Add: Difference between revisions

Revision as of 16:55, 24 January 2018

add( tbl, v  )

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

tbl

The table.

v

The value to add.

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.

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

@@ Line 7: / Line 7: @@
 The <code>add()</code> function appends an element to the end of a sequence in a table.
-Specifically, <code>add()</code> looks for an element at index 1, increments the index until it finds no element assigned (<code>nil</code>), then assigns the new value to that unused index.
+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 <code>add()</code> function returns the object being added. (You can ignore this return value.)
+The <code>add()</code> function returns the object being added. You can ignore this return value, or pass it back to your own caller.
 == Examples ==