addn

The addn function adds a value to a general lua table that may contain a multi-dimensional array or a mixture of numbers, strings, named keys, and sub-tables. Only numeric values found in the table are used in the calculation. The related add function adds a number to a 1-dimensional array, CImage, or list of numbers. Since an array is a specific type of table that contains only numbers or sub-tables, this function can also be used for arrays.

Syntax

new_table = add( tbl, value )

tbl is a general lua table.

value is a number.

new_table is the returned table.

Examples

The following script adds 3200.5 to all members of a 1-dimensional array.

t = random(10000)	-- create 10000 random numbers
t = addn( t, 3200.5 )	-- add the number to all members of the array

The next script adds 3200.5 to the values in a complex, ugly table:

t = { 6, -2, 15, "a", {5,"b"}, c="5.4" }
tnew = addn(t, 3200.5)	-- add 3200.5

Syntax

Examples

Related Topics