Table

New in version 8.1.3.

The pilight metatable can be used using the table object. The main difference from the default lua tables is that in pilight lua tables, the order in which keys are set is the same as the order in which the keys are iterated.

To get the length of a pilight lua table you need to use the special .__len() function.

local table = pilight.table();
table[0] = 'foo';
print(table.__len());

Changed in version 8.1.5.

Note

The push, pop, shift, and unshift functions only work on numeric tables.

number len()

Returns the number of values stored in the table

local table = pilight.table();
table[0] = 'foo';
print(table.len());

boolean push(string | number | boolean | table)

Pushes a value at the end of the table

local table = pilight.table();
table.push(1);

boolean shift(string | number | boolean | table)

Adds a value at the beginning of the table

local table = pilight.table();
table.shift(1);

userdata pop()

Retrieves the value from the end of the table

local table = pilight.table();
print(table.pop());

userdata unshift()

Retrieves the value from the beginning of the table

local table = pilight.table();
print(table.unshift());