sol2/docs/source/api/metatable_key.rst

metatable_key
=============
*a key for setting and getting an object's metatable*


.. code-block:: cpp

	struct metatable_key_t {};
	const metatable_key_t metatable_key;

You can use this in conjunction with :doc:`sol::table<table>` to set/get a metatable. Lua metatables are powerful ways to override default behavior of objects for various kinds of operators, among other things. Here is an entirely complete example, showing getting and working with a :doc:`usertype<usertype>`'s metatable defined by Sol:

.. literalinclude:: ../../../examples/metatable_key_low_level.cpp
	:caption: messing with metatables
	:linenos:
This commit adds some QoI constructor keys / types, as well as implements `make_object`. The documentation has been updated as well. Closes #78 Closes #77 Closes #76 Closes #75 2016-05-04 02:19:30 +08:00			`metatable_key`
			`=============`
this mega commit prepares to fix all of the issues listed in the repository for the past 3 weeks 2017-08-06 07:20:28 +08:00			`a key for setting and getting an object's metatable`

This commit adds some QoI constructor keys / types, as well as implements `make_object`. The documentation has been updated as well. Closes #78 Closes #77 Closes #76 Closes #75 2016-05-04 02:19:30 +08:00
			`.. code-block:: cpp`

			`struct metatable_key_t {};`
			`const metatable_key_t metatable_key;`

			You can use this in conjunction with :doc:`sol::table<table>` to set/get a metatable. Lua metatables are powerful ways to override default behavior of objects for various kinds of operators, among other things. Here is an entirely complete example, showing getting and working with a :doc:`usertype<usertype>`'s metatable defined by Sol:

prepare for new usertype change how type T is gleaned from destructors and constructors in case of new syntax add a hell of a lot more examples, update and clean documentation 2018-03-16 05:16:28 +08:00			`.. literalinclude:: ../../../examples/metatable_key_low_level.cpp`
This commit adds some QoI constructor keys / types, as well as implements `make_object`. The documentation has been updated as well. Closes #78 Closes #77 Closes #76 Closes #75 2016-05-04 02:19:30 +08:00			`:caption: messing with metatables`
			`:linenos:`