net.sandius.rembulan

Interface MetatableAccessor

All Superinterfaces:

MetatableProvider

All Known Subinterfaces:

ExecutionContext, StateContext

All Known Implementing Classes:

AbstractStateContext

public interface MetatableAccessor
extends MetatableProvider

A metatable accessor, an interface for getting and setting object metatables.

In Lua, only tables and (full) userdata carry their own metatables; for all other types of values T, all values of type T share a metatable. This interface provides a uniform setter for metatables of all types.

Method Summary

Modifier and Type	Method and Description
Table	setBooleanMetatable(Table table) Sets the metatable for the boolean type.
Table	setFunctionMetatable(Table table) Sets the metatable for the function type.
Table	setLightUserdataMetatable(Table table) Sets the metatable for light userdata.
Table	setMetatable(Object instance, Table table) Sets the metatable of the object instance to table.
Table	setNilMetatable(Table table) Sets the metatable for nil (i.e., the nil type) to table.
Table	setNumberMetatable(Table table) Sets the metatable for the number type.
Table	setStringMetatable(Table table) Sets the metatable for the string type.
Table	setThreadMetatable(Table table) Sets the metatable for the thread type.

Methods inherited from interface net.sandius.rembulan.MetatableProvider

getBooleanMetatable, getFunctionMetatable, getLightUserdataMetatable, getMetatable, getNilMetatable, getNumberMetatable, getStringMetatable, getThreadMetatable

Method Detail

setNilMetatable

Table setNilMetatable(Table table)

Sets the metatable for nil (i.e., the nil type) to table. table may be null: in that case, clears the metatable. Returns the previous metatable.

Parameters:

table - new metatable for the nil type, may be null

Returns:

the previous metatable for the nil type

setBooleanMetatable

Table setBooleanMetatable(Table table)

Sets the metatable for the boolean type. table may be null: in that case, clears the metatable. Returns the previous metatable.

Parameters:

table - new metatable for the boolean type, may be null

Returns:

the previous metatable for the boolean type

setNumberMetatable

Table setNumberMetatable(Table table)

Sets the metatable for the number type. table may be null: in that case, clears the metatable. Returns the previous metatable.

Parameters:

table - new metatable for the number type, may be null

Returns:

the previous metatable for the number type

setStringMetatable

Table setStringMetatable(Table table)

Sets the metatable for the string type. table may be null: in that case, clears the metatable. Returns the previous metatable.

Parameters:

table - new metatable for the string type, may be null

Returns:

the previous metatable for the string type

setFunctionMetatable

Table setFunctionMetatable(Table table)

Sets the metatable for the function type. table may be null: in that case, clears the metatable. Returns the previous metatable.

Parameters:

table - new metatable for the function type, may be null

Returns:

the previous metatable for the function type

setThreadMetatable

Table setThreadMetatable(Table table)

Sets the metatable for the thread type. table may be null: in that case, clears the metatable. Returns the previous metatable.

Parameters:

table - new metatable for the thread type, may be null

Returns:

the previous metatable for the thread type

setLightUserdataMetatable

Table setLightUserdataMetatable(Table table)

Sets the metatable for light userdata. table may be null: in that case, clears the metatable. Returns the previous metatable.

Parameters:

table - new metatable for light userdata, may be null

Returns:

the previous metatable for light userdata

setMetatable

Table setMetatable(Object instance,
                   Table table)

Sets the metatable of the object instance to table. table may be null: in that case, clears instance's metatable. Returns the previous metatable.

Note that instance may share the metatable with other instances of the same (Lua) type. This method provides a uniform interface for setting the metatables of all types.

Parameters:

instance - object to set the metatable of, may be null

table - new metatable of instance, may be null

Returns:

the previous metatable of instance