Script values

Two scripts exchange copies. Whatever crosses between them, in either direction, arrives as an ordinary Lua value of the script it arrives in:

It does not matter which way the value travels or which call carries it: set, get, the arguments and results of call, the arguments of a function you put into another script, a field read with table_get. A value you receive is yours, nothing has to be given back, and changing it changes nothing in the other script.

A reference, when you want one

A copy is what you want nearly always. The exception is a table you mean to go on writing into after the other script has it, where a copy would stop being the same table. For that there is a reference, and two functions give one:

• make_table makes a table in the other script;
• make_function makes a function there that calls one of yours.

local state = natiny.script.make_table(mod)       -- a reference

print(state.type == natiny.script.TABLE)          --> true
print(state.script == mod)                        --> true

A reference names the thing over there. table_set through it is seen at once, and passing it to set gives the other script that same table under a name. What the table functions read out of it is a copy again.

There is nothing to release. A reference is released when Lua collects it, the same way a table of your own is freed when nothing refers to it any more.

Type tags

natiny.script.MAX_ARGS and natiny.script.MAX_RESULTS are both 16.