divn


The divn function divides a general lua table by a number. The table may contain non-numeric values, named keys, and sub-tables. Only numeric values found in the table are used in the calculation. To divide the table into a number, use xdivn. The related div function returns the minimum value of a 1-dimensional array or CImage. 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 = divn( tbl, value )

bullet.gif    where tbl is a general lua table.

bullet.gif    value is a number.

bullet.gif    new_table is returned as a new table. If value is zero, tbl is unchanged and nil is returned.

Examples

The following script divides a 1-dimensional array by 3200.5.

t = divn( array, 3200.5 )

-- divide the array by the value

  

The next script divides the numeric members of a more complex table by 3200.5. Only the 4 numeric values are divided.

tbl = { 15, a=5.5, z={"c", 20}, -12 }

 

t = divn( tbl, 3200.5 )

-- divide the table by the value

Related Topics

Table and Array Functions

muln

div

xdivn


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