addn


The addn function adds a value to a general lua table that may contain non-numeric values, 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 )

bullet.gif    tbl is a general lua table.

bullet.gif    value is a number.

bullet.gif    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

Related Topics

Table and Array Functions

subn

add


Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All Rights Reserved.