Table Functions

VOID table(TABLE_V);

declare a table

VOID insert(TABLE, STRING, ANY);

insert entry in table

ANY lookup(TABLE, STRING);

lookup and return entry from table

These functions provide general purpose, keyed tables. A table must be declared with the table function before it can be used.

Insert adds an object and its key to a table. Its first parameter is a table; the second parameter is the object's key; and the third parameter is the object itself. The key must be a string and the object can be any value. If there already is an object in the table with that key, the old object is replaced with the new.

Lookup retrieves an object from a table. Its first parameter is a table, and the second parameter is the object's key. The function returns the object with that key from the table; if there is no such object, null is returned.