// sol3 // The MIT License (MIT) // Copyright (c) 2013-2021 Rapptz, ThePhD and contributors // Permission is hereby granted, free of charge, to any person obtaining a copy of // this software and associated documentation files (the "Software"), to deal in // the Software without restriction, including without limitation the rights to // use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of // the Software, and to permit persons to whom the Software is furnished to do so, // subject to the following conditions: // The above copyright notice and this permission notice shall be included in all // copies or substantial portions of the Software. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS // FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR // COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER // IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN // CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. #ifndef SOL_METATABLE_HPP #define SOL_METATABLE_HPP #include #include namespace sol { template class basic_metatable : public basic_table { typedef basic_table base_t; friend class state; friend class state_view; protected: basic_metatable(detail::no_safety_tag, lua_nil_t n) : base_t(n) { } basic_metatable(detail::no_safety_tag, lua_State* L, int index) : base_t(L, index) { } basic_metatable(detail::no_safety_tag, lua_State* L, ref_index index) : base_t(L, index) { } template , basic_metatable>>, meta::neg>, meta::neg>>, is_lua_reference>> = meta::enabler> basic_metatable(detail::no_safety_tag, T&& r) noexcept : base_t(std::forward(r)) { } template >> = meta::enabler> basic_metatable(detail::no_safety_tag, lua_State* L, T&& r) noexcept : base_t(L, std::forward(r)) { } template > void set_fx(types, Key&& key, Fx&& fx) { set_resolved_function(std::forward(key), std::forward(fx)); } template , overload_set>> = meta::enabler> void set_fx(types<>, Key&& key, Fx&& fx) { set(std::forward(key), std::forward(fx)); } template , overload_set>> = meta::enabler> void set_fx(types<>, Key&& key, Fx&& fx, Args&&... args) { set(std::forward(key), as_function_reference(std::forward(fx), std::forward(args)...)); } template void set_resolved_function(Key&& key, Args&&... args) { set(std::forward(key), as_function_reference>(std::forward(args)...)); } public: using base_t::lua_state; basic_metatable() noexcept = default; basic_metatable(const basic_metatable&) = default; basic_metatable(basic_metatable&&) = default; basic_metatable& operator=(const basic_metatable&) = default; basic_metatable& operator=(basic_metatable&&) = default; basic_metatable(const stack_reference& r) : basic_metatable(r.lua_state(), r.stack_index()) { } basic_metatable(stack_reference&& r) : basic_metatable(r.lua_state(), r.stack_index()) { } template >> = meta::enabler> basic_metatable(lua_State* L, T&& r) : base_t(L, std::forward(r)) { #if SOL_IS_ON(SOL_SAFE_REFERENCES_I_) auto pp = stack::push_pop(*this); constructor_handler handler {}; stack::check(lua_state(), -1, handler); #endif // Safety } basic_metatable(lua_State* L, int index = -1) : basic_metatable(detail::no_safety, L, index) { #if SOL_IS_ON(SOL_SAFE_REFERENCES_I_) constructor_handler handler {}; stack::check(L, index, handler); #endif // Safety } basic_metatable(lua_State* L, ref_index index) : basic_metatable(detail::no_safety, L, index) { #if SOL_IS_ON(SOL_SAFE_REFERENCES_I_) auto pp = stack::push_pop(*this); constructor_handler handler {}; stack::check(lua_state(), -1, handler); #endif // Safety } template , basic_metatable>>, meta::neg>, meta::neg>>, is_lua_reference>> = meta::enabler> basic_metatable(T&& r) noexcept : basic_metatable(detail::no_safety, std::forward(r)) { #if SOL_IS_ON(SOL_SAFE_REFERENCES_I_) if (!is_table>::value) { auto pp = stack::push_pop(*this); constructor_handler handler {}; stack::check(base_t::lua_state(), -1, handler); } #endif // Safety } basic_metatable(lua_nil_t r) noexcept : basic_metatable(detail::no_safety, r) { } template basic_metatable& set(Key&& key, Value&& value); template basic_metatable& set_function(Key&& key, Args&&... args) { set_fx(types(), std::forward(key), std::forward(args)...); return *this; } template basic_metatable& set_function(Key&& key, Args&&... args) { set_fx(types<>(), std::forward(key), std::forward(args)...); return *this; } void unregister() { using ustorage_base = u_detail::usertype_storage_base; lua_State* L = this->lua_state(); auto pp = stack::push_pop(*this); int top = lua_gettop(L); stack_reference mt(L, -1); stack::get_field(L, meta_function::gc_names, mt.stack_index()); if (type_of(L, -1) != type::table) { lua_settop(L, top); return; } stack_reference gc_names_table(L, -1); stack::get_field(L, meta_function::storage, mt.stack_index()); if (type_of(L, -1) != type::lightuserdata) { lua_settop(L, top); return; } ustorage_base& base_storage = *static_cast(stack::get(L, -1)); std::array registry_traits; for (std::size_t i = 0; i < registry_traits.size(); ++i) { u_detail::submetatable_type smt = static_cast(i); stack::get_field(L, smt, gc_names_table.stack_index()); registry_traits[i] = stack::get(L, -1); } // get the registry stack_reference registry(L, raw_index(LUA_REGISTRYINDEX)); registry.push(); // eliminate all named entries for this usertype // in the registry (luaL_newmetatable does // [name] = new table // in registry upon creation) for (std::size_t i = 0; i < registry_traits.size(); ++i) { u_detail::submetatable_type smt = static_cast(i); const string_view& gcmetakey = registry_traits[i]; if (smt == u_detail::submetatable_type::named) { // use .data() to make it treat it like a c string, // which it is... stack::set_field(L, gcmetakey.data(), lua_nil); } else { // do not change the values in the registry: they need to be present // no matter what, for safety's sake // stack::set_field(L, gcmetakey, lua_nil, registry.stack_index()); } } // destroy all storage and tables base_storage.clear(); // 6 strings from gc_names table, // + 1 registry, // + 1 gc_names table // + 1 light userdata of storage // + 1 registry // 10 total, 4 left since popping off 6 gc_names tables lua_settop(L, top); } }; } // namespace sol #endif // SOL_METATABLE_HPP