aboutsummaryrefslogtreecommitdiffstats
path: root/lib/sol2/docs/source/api/metatable_key.rst
diff options
context:
space:
mode:
authorAndy <drumsetmonkey@gmail.com>2019-08-29 13:07:45 -0400
committerAndy <drumsetmonkey@gmail.com>2019-08-29 13:07:45 -0400
commit4ac4b280abf2ffa28caa5a532353115a3033444f (patch)
tree2a13d658bb454360b2faf401244bb0321d3460d4 /lib/sol2/docs/source/api/metatable_key.rst
parente9758416b18b27a65337c28d9641afc0ee89b34b (diff)
parent7a46fa2dd3dad3f038bf8e7339bc67abca428ae6 (diff)
Started creating scripting library/namespace and added sol2 for interfacing
Diffstat (limited to 'lib/sol2/docs/source/api/metatable_key.rst')
-rw-r--r--lib/sol2/docs/source/api/metatable_key.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/lib/sol2/docs/source/api/metatable_key.rst b/lib/sol2/docs/source/api/metatable_key.rst
new file mode 100644
index 0000000..7eeff47
--- /dev/null
+++ b/lib/sol2/docs/source/api/metatable_key.rst
@@ -0,0 +1,16 @@
+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/source/metatable_key_low_level.cpp
+ :caption: messing with metatables
+ :name: sol-metatable_key-eg
+ :linenos: