mirror of
				https://github.com/OpenMW/openmw.git
				synced 2025-10-31 21:56:41 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			874 lines
		
	
	
	
		
			31 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			874 lines
		
	
	
	
		
			31 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| // sol2
 | |
| 
 | |
| // 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_STATE_VIEW_HPP
 | |
| #define SOL_STATE_VIEW_HPP
 | |
| 
 | |
| #include <sol/error.hpp>
 | |
| #include <sol/table.hpp>
 | |
| #include <sol/environment.hpp>
 | |
| #include <sol/load_result.hpp>
 | |
| #include <sol/state_handling.hpp>
 | |
| 
 | |
| #include <memory>
 | |
| #include <cstddef>
 | |
| 
 | |
| namespace sol {
 | |
| 
 | |
| 	class state_view {
 | |
| 	private:
 | |
| 		lua_State* L;
 | |
| 		table reg;
 | |
| 		global_table global;
 | |
| 
 | |
| 		optional<object> is_loaded_package(const std::string& key) {
 | |
| 			auto loaded = reg.traverse_get<optional<object>>("_LOADED", key);
 | |
| 			bool is53mod = loaded && !(loaded->is<bool>() && !loaded->as<bool>());
 | |
| 			if (is53mod)
 | |
| 				return loaded;
 | |
| #if SOL_LUA_VERSION_I_ <= 501
 | |
| 			auto loaded51 = global.traverse_get<optional<object>>("package", "loaded", key);
 | |
| 			bool is51mod = loaded51 && !(loaded51->is<bool>() && !loaded51->as<bool>());
 | |
| 			if (is51mod)
 | |
| 				return loaded51;
 | |
| #endif
 | |
| 			return nullopt;
 | |
| 		}
 | |
| 
 | |
| 		template <typename T>
 | |
| 		void ensure_package(const std::string& key, T&& sr) {
 | |
| #if SOL_LUA_VERSION_I_ <= 501
 | |
| 			auto pkg = global["package"];
 | |
| 			if (!pkg.valid()) {
 | |
| 				pkg = create_table_with("loaded", create_table_with(key, sr));
 | |
| 			}
 | |
| 			else {
 | |
| 				auto ld = pkg["loaded"];
 | |
| 				if (!ld.valid()) {
 | |
| 					ld = create_table_with(key, sr);
 | |
| 				}
 | |
| 				else {
 | |
| 					ld[key] = sr;
 | |
| 				}
 | |
| 			}
 | |
| #endif
 | |
| 			auto loaded = reg["_LOADED"];
 | |
| 			if (!loaded.valid()) {
 | |
| 				loaded = create_table_with(key, sr);
 | |
| 			}
 | |
| 			else {
 | |
| 				loaded[key] = sr;
 | |
| 			}
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx>
 | |
| 		object require_core(const std::string& key, Fx&& action, bool create_global = true) {
 | |
| 			optional<object> loaded = is_loaded_package(key);
 | |
| 			if (loaded && loaded->valid())
 | |
| 				return std::move(*loaded);
 | |
| 			int before = lua_gettop(L);
 | |
| 			action();
 | |
| 			int after = lua_gettop(L);
 | |
| 			if (before == after) {
 | |
| 				// I mean, you were supposed to return
 | |
| 				// something, ANYTHING, from your requires script. I guess I'll just
 | |
| 				// but some trash in here, it's on you after that?
 | |
| 				ensure_package(key, static_cast<void*>(L));
 | |
| 				return object(L, lua_nil);
 | |
| 			}
 | |
| 			stack_reference sr(L, -1);
 | |
| 			if (create_global)
 | |
| 				set(key, sr);
 | |
| 			ensure_package(key, sr);
 | |
| 			return stack::pop<object>(L);
 | |
| 		}
 | |
| 
 | |
| 	public:
 | |
| 		using iterator = typename global_table::iterator;
 | |
| 		using const_iterator = typename global_table::const_iterator;
 | |
| 
 | |
| 		state_view(lua_State* Ls) : L(Ls), reg(Ls, LUA_REGISTRYINDEX), global(Ls, global_tag) {
 | |
| 		}
 | |
| 
 | |
| 		state_view(this_state Ls) : state_view(Ls.L) {
 | |
| 		}
 | |
| 
 | |
| 		lua_State* lua_state() const {
 | |
| 			return L;
 | |
| 		}
 | |
| 
 | |
| 		template <typename... Args>
 | |
| 		void open_libraries(Args&&... args) {
 | |
| 			static_assert(meta::all_same<lib, meta::unqualified_t<Args>...>::value, "all types must be libraries");
 | |
| 			if constexpr (sizeof...(args) == 0) {
 | |
| 				luaL_openlibs(L);
 | |
| 				return;
 | |
| 			}
 | |
| 			else {
 | |
| 				lib libraries[1 + sizeof...(args)] = { lib::count, std::forward<Args>(args)... };
 | |
| 
 | |
| 				for (auto&& library : libraries) {
 | |
| 					switch (library) {
 | |
| #if SOL_LUA_VERSION_I_ <= 501 && SOL_IS_ON(SOL_USE_LUAJIT_I_)
 | |
| 					case lib::coroutine:
 | |
| #endif // luajit opens coroutine base stuff
 | |
| 					case lib::base:
 | |
| 						luaL_requiref(L, "base", luaopen_base, 1);
 | |
| 						lua_pop(L, 1);
 | |
| 						break;
 | |
| 					case lib::package:
 | |
| 						luaL_requiref(L, "package", luaopen_package, 1);
 | |
| 						lua_pop(L, 1);
 | |
| 						break;
 | |
| #if SOL_IS_OFF(SOL_USE_LUAJIT_I_)
 | |
| 					case lib::coroutine:
 | |
| #if SOL_LUA_VERSION_I_ > 501
 | |
| 						luaL_requiref(L, "coroutine", luaopen_coroutine, 1);
 | |
| 						lua_pop(L, 1);
 | |
| #endif // Lua 5.2+ only
 | |
| 						break;
 | |
| #endif // Not LuaJIT - comes builtin
 | |
| 					case lib::string:
 | |
| 						luaL_requiref(L, "string", luaopen_string, 1);
 | |
| 						lua_pop(L, 1);
 | |
| 						break;
 | |
| 					case lib::table:
 | |
| 						luaL_requiref(L, "table", luaopen_table, 1);
 | |
| 						lua_pop(L, 1);
 | |
| 						break;
 | |
| 					case lib::math:
 | |
| 						luaL_requiref(L, "math", luaopen_math, 1);
 | |
| 						lua_pop(L, 1);
 | |
| 						break;
 | |
| 					case lib::bit32:
 | |
| #if SOL_IS_ON(SOL_USE_LUAJIT_I_)
 | |
| 						luaL_requiref(L, "bit32", luaopen_bit, 1);
 | |
| 						lua_pop(L, 1);
 | |
| #elif SOL_IS_ON(SOL_LUA_BIT32_LIB_I_)
 | |
| 						luaL_requiref(L, "bit32", luaopen_bit32, 1);
 | |
| 						lua_pop(L, 1);
 | |
| #else
 | |
| #endif
 | |
| 						break;
 | |
| 					case lib::io:
 | |
| 						luaL_requiref(L, "io", luaopen_io, 1);
 | |
| 						lua_pop(L, 1);
 | |
| 						break;
 | |
| 					case lib::os:
 | |
| 						luaL_requiref(L, "os", luaopen_os, 1);
 | |
| 						lua_pop(L, 1);
 | |
| 						break;
 | |
| 					case lib::debug:
 | |
| 						luaL_requiref(L, "debug", luaopen_debug, 1);
 | |
| 						lua_pop(L, 1);
 | |
| 						break;
 | |
| 					case lib::utf8:
 | |
| #if SOL_LUA_VERSION_I_ > 502 && SOL_IS_OFF(SOL_USE_LUAJIT_I_)
 | |
| 						luaL_requiref(L, "utf8", luaopen_utf8, 1);
 | |
| 						lua_pop(L, 1);
 | |
| #endif // Lua 5.3+ only
 | |
| 						break;
 | |
| 					case lib::ffi:
 | |
| #if SOL_IS_ON(SOL_USE_LUAJIT_I_) && SOL_IS_OFF(SOL_LUAJIT_FFI_DISABLED_I_)
 | |
| 						luaL_requiref(L, "ffi", luaopen_ffi, 1);
 | |
| 						lua_pop(L, 1);
 | |
| #endif // LuaJIT only
 | |
| 						break;
 | |
| 					case lib::jit:
 | |
| #if SOL_IS_ON(SOL_USE_LUAJIT_I_)
 | |
| 						luaL_requiref(L, "jit", luaopen_jit, 0);
 | |
| 						lua_pop(L, 1);
 | |
| #endif // LuaJIT Only
 | |
| 						break;
 | |
| 					case lib::count:
 | |
| 					default:
 | |
| 						break;
 | |
| 					}
 | |
| 				}
 | |
| 			}
 | |
| 		}
 | |
| 
 | |
| 		object require(const std::string& key, lua_CFunction open_function, bool create_global = true) {
 | |
| 			luaL_requiref(L, key.c_str(), open_function, create_global ? 1 : 0);
 | |
| 			return stack::pop<object>(L);
 | |
| 		}
 | |
| 
 | |
| 		object require_script(const std::string& key, const string_view& code, bool create_global = true,
 | |
| 		     const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			auto action = [this, &code, &chunkname, &mode]() { stack::script(L, code, chunkname, mode); };
 | |
| 			return require_core(key, action, create_global);
 | |
| 		}
 | |
| 
 | |
| 		object require_file(const std::string& key, const std::string& filename, bool create_global = true, load_mode mode = load_mode::any) {
 | |
| 			auto action = [this, &filename, &mode]() { stack::script_file(L, filename, mode); };
 | |
| 			return require_core(key, action, create_global);
 | |
| 		}
 | |
| 
 | |
| 		void clear_package_loaders() {
 | |
| 			optional<table> maybe_package = this->global["package"];
 | |
| 			if (!maybe_package) {
 | |
| 				// package lib wasn't opened
 | |
| 				// open package lib
 | |
| 				return;
 | |
| 			}
 | |
| 			table& package = *maybe_package;
 | |
| 			// yay for version differences...
 | |
| 			// one day Lua 5.1 will die a peaceful death
 | |
| 			// and its old bones will find blissful rest
 | |
| 			auto loaders_proxy = package
 | |
| #if SOL_LUA_VERSION_I_ < 502
 | |
| 			     ["loaders"]
 | |
| #else
 | |
| 			     ["searchers"]
 | |
| #endif
 | |
| 			     ;
 | |
| 			if (!loaders_proxy.valid()) {
 | |
| 				// nothing to clear
 | |
| 				return;
 | |
| 			}
 | |
| 			// we need to create the table for loaders
 | |
| 			// table does not exist, so create and move forward
 | |
| 			loaders_proxy = new_table(1, 0);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx>
 | |
| 		void add_package_loader(Fx&& fx, bool clear_all_package_loaders = false) {
 | |
| 			optional<table> maybe_package = this->global["package"];
 | |
| 			if (!maybe_package) {
 | |
| 				// package lib wasn't opened
 | |
| 				// open package lib
 | |
| 				return;
 | |
| 			}
 | |
| 			table& package = *maybe_package;
 | |
| 			// yay for version differences...
 | |
| 			// one day Lua 5.1 will die a peaceful death
 | |
| 			// and its old bones will find blissful rest
 | |
| 			auto loaders_proxy = package
 | |
| #if SOL_LUA_VERSION_I_ < 502
 | |
| 			     ["loaders"]
 | |
| #else
 | |
| 			     ["searchers"]
 | |
| #endif
 | |
| 			     ;
 | |
| 			bool make_new_table = clear_all_package_loaders || !loaders_proxy.valid();
 | |
| 			if (make_new_table) {
 | |
| 				// we need to create the table for loaders
 | |
| 				// table does not exist, so create and move forward
 | |
| 				loaders_proxy = new_table(1, 0);
 | |
| 			}
 | |
| 			optional<table> maybe_loaders = loaders_proxy;
 | |
| 			if (!maybe_loaders) {
 | |
| 				// loaders/searches
 | |
| 				// thing exists in package, but it
 | |
| 				// ain't a table or a table-alike...!
 | |
| 				return;
 | |
| 			}
 | |
| 			table loaders = loaders_proxy;
 | |
| 			loaders.add(std::forward<Fx>(fx));
 | |
| 		}
 | |
| 
 | |
| 		template <typename E>
 | |
| 		protected_function_result do_reader(lua_Reader reader, void* data, const basic_environment<E>& env,
 | |
| 		     const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			detail::typical_chunk_name_t basechunkname = {};
 | |
| 			const char* chunknametarget = detail::make_chunk_name("lua_Reader", chunkname, basechunkname);
 | |
| 			load_status x = static_cast<load_status>(lua_load(L, reader, data, chunknametarget, to_string(mode).c_str()));
 | |
| 			if (x != load_status::ok) {
 | |
| 				return protected_function_result(L, absolute_index(L, -1), 0, 1, static_cast<call_status>(x));
 | |
| 			}
 | |
| 			stack_aligned_protected_function pf(L, -1);
 | |
| 			set_environment(env, pf);
 | |
| 			return pf();
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result do_reader(
 | |
| 		     lua_Reader reader, void* data, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			detail::typical_chunk_name_t basechunkname = {};
 | |
| 			const char* chunknametarget = detail::make_chunk_name("lua_Reader", chunkname, basechunkname);
 | |
| 			load_status x = static_cast<load_status>(lua_load(L, reader, data, chunknametarget, to_string(mode).c_str()));
 | |
| 			if (x != load_status::ok) {
 | |
| 				return protected_function_result(L, absolute_index(L, -1), 0, 1, static_cast<call_status>(x));
 | |
| 			}
 | |
| 			stack_aligned_protected_function pf(L, -1);
 | |
| 			return pf();
 | |
| 		}
 | |
| 
 | |
| 		template <typename E>
 | |
| 		protected_function_result do_string(const string_view& code, const basic_environment<E>& env,
 | |
| 		     const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			detail::typical_chunk_name_t basechunkname = {};
 | |
| 			const char* chunknametarget = detail::make_chunk_name(code, chunkname, basechunkname);
 | |
| 			load_status x = static_cast<load_status>(luaL_loadbufferx(L, code.data(), code.size(), chunknametarget, to_string(mode).c_str()));
 | |
| 			if (x != load_status::ok) {
 | |
| 				return protected_function_result(L, absolute_index(L, -1), 0, 1, static_cast<call_status>(x));
 | |
| 			}
 | |
| 			stack_aligned_protected_function pf(L, -1);
 | |
| 			set_environment(env, pf);
 | |
| 			return pf();
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result do_string(
 | |
| 		     const string_view& code, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			detail::typical_chunk_name_t basechunkname = {};
 | |
| 			const char* chunknametarget = detail::make_chunk_name(code, chunkname, basechunkname);
 | |
| 			load_status x = static_cast<load_status>(luaL_loadbufferx(L, code.data(), code.size(), chunknametarget, to_string(mode).c_str()));
 | |
| 			if (x != load_status::ok) {
 | |
| 				return protected_function_result(L, absolute_index(L, -1), 0, 1, static_cast<call_status>(x));
 | |
| 			}
 | |
| 			stack_aligned_protected_function pf(L, -1);
 | |
| 			return pf();
 | |
| 		}
 | |
| 
 | |
| 		template <typename E>
 | |
| 		protected_function_result do_file(const std::string& filename, const basic_environment<E>& env, load_mode mode = load_mode::any) {
 | |
| 			load_status x = static_cast<load_status>(luaL_loadfilex(L, filename.c_str(), to_string(mode).c_str()));
 | |
| 			if (x != load_status::ok) {
 | |
| 				return protected_function_result(L, absolute_index(L, -1), 0, 1, static_cast<call_status>(x));
 | |
| 			}
 | |
| 			stack_aligned_protected_function pf(L, -1);
 | |
| 			set_environment(env, pf);
 | |
| 			return pf();
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result do_file(const std::string& filename, load_mode mode = load_mode::any) {
 | |
| 			load_status x = static_cast<load_status>(luaL_loadfilex(L, filename.c_str(), to_string(mode).c_str()));
 | |
| 			if (x != load_status::ok) {
 | |
| 				return protected_function_result(L, absolute_index(L, -1), 0, 1, static_cast<call_status>(x));
 | |
| 			}
 | |
| 			stack_aligned_protected_function pf(L, -1);
 | |
| 			return pf();
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx,
 | |
| 		     meta::disable_any<meta::is_string_constructible<meta::unqualified_t<Fx>>,
 | |
| 		          meta::is_specialization_of<meta::unqualified_t<Fx>, basic_environment>> = meta::enabler>
 | |
| 		protected_function_result safe_script(
 | |
| 		     lua_Reader reader, void* data, Fx&& on_error, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			protected_function_result pfr = do_reader(reader, data, chunkname, mode);
 | |
| 			if (!pfr.valid()) {
 | |
| 				return on_error(L, std::move(pfr));
 | |
| 			}
 | |
| 			return pfr;
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result safe_script(
 | |
| 		     lua_Reader reader, void* data, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return safe_script(reader, data, script_default_on_error, chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx,
 | |
| 		     meta::disable_any<meta::is_string_constructible<meta::unqualified_t<Fx>>,
 | |
| 		          meta::is_specialization_of<meta::unqualified_t<Fx>, basic_environment>> = meta::enabler>
 | |
| 		protected_function_result safe_script(
 | |
| 		     const string_view& code, Fx&& on_error, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			protected_function_result pfr = do_string(code, chunkname, mode);
 | |
| 			if (!pfr.valid()) {
 | |
| 				return on_error(L, std::move(pfr));
 | |
| 			}
 | |
| 			return pfr;
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx, typename E>
 | |
| 		protected_function_result safe_script(const string_view& code, const basic_environment<E>& env, Fx&& on_error,
 | |
| 		     const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			protected_function_result pfr = do_string(code, env, chunkname, mode);
 | |
| 			if (!pfr.valid()) {
 | |
| 				return on_error(L, std::move(pfr));
 | |
| 			}
 | |
| 			return pfr;
 | |
| 		}
 | |
| 
 | |
| 		template <typename E>
 | |
| 		protected_function_result safe_script(const string_view& code, const basic_environment<E>& env,
 | |
| 		     const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return safe_script(code, env, script_default_on_error, chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result safe_script(
 | |
| 		     const string_view& code, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return safe_script(code, script_default_on_error, chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx,
 | |
| 		     meta::disable_any<meta::is_string_constructible<meta::unqualified_t<Fx>>,
 | |
| 		          meta::is_specialization_of<meta::unqualified_t<Fx>, basic_environment>> = meta::enabler>
 | |
| 		protected_function_result safe_script_file(const std::string& filename, Fx&& on_error, load_mode mode = load_mode::any) {
 | |
| 			protected_function_result pfr = do_file(filename, mode);
 | |
| 			if (!pfr.valid()) {
 | |
| 				return on_error(L, std::move(pfr));
 | |
| 			}
 | |
| 			return pfr;
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx, typename E>
 | |
| 		protected_function_result safe_script_file(
 | |
| 		     const std::string& filename, const basic_environment<E>& env, Fx&& on_error, load_mode mode = load_mode::any) {
 | |
| 			protected_function_result pfr = do_file(filename, env, mode);
 | |
| 			if (!pfr.valid()) {
 | |
| 				return on_error(L, std::move(pfr));
 | |
| 			}
 | |
| 			return pfr;
 | |
| 		}
 | |
| 
 | |
| 		template <typename E>
 | |
| 		protected_function_result safe_script_file(const std::string& filename, const basic_environment<E>& env, load_mode mode = load_mode::any) {
 | |
| 			return safe_script_file(filename, env, script_default_on_error, mode);
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result safe_script_file(const std::string& filename, load_mode mode = load_mode::any) {
 | |
| 			return safe_script_file(filename, script_default_on_error, mode);
 | |
| 		}
 | |
| 
 | |
| 		template <typename E>
 | |
| 		unsafe_function_result unsafe_script(lua_Reader reader, void* data, const basic_environment<E>& env,
 | |
| 		     const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			detail::typical_chunk_name_t basechunkname = {};
 | |
| 			const char* chunknametarget = detail::make_chunk_name("lua_Reader", chunkname, basechunkname);
 | |
| 			int index = lua_gettop(L);
 | |
| 			if (lua_load(L, reader, data, chunknametarget, to_string(mode).c_str())) {
 | |
| 				lua_error(L);
 | |
| 			}
 | |
| 			set_environment(env, stack_reference(L, raw_index(index + 1)));
 | |
| 			if (lua_pcall(L, 0, LUA_MULTRET, 0)) {
 | |
| 				lua_error(L);
 | |
| 			}
 | |
| 			int postindex = lua_gettop(L);
 | |
| 			int returns = postindex - index;
 | |
| 			return unsafe_function_result(L, (std::max)(postindex - (returns - 1), 1), returns);
 | |
| 		}
 | |
| 
 | |
| 		unsafe_function_result unsafe_script(
 | |
| 		     lua_Reader reader, void* data, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			int index = lua_gettop(L);
 | |
| 			stack::script(L, reader, data, chunkname, mode);
 | |
| 			int postindex = lua_gettop(L);
 | |
| 			int returns = postindex - index;
 | |
| 			return unsafe_function_result(L, (std::max)(postindex - (returns - 1), 1), returns);
 | |
| 		}
 | |
| 
 | |
| 		template <typename E>
 | |
| 		unsafe_function_result unsafe_script(const string_view& code, const basic_environment<E>& env,
 | |
| 		     const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			detail::typical_chunk_name_t basechunkname = {};
 | |
| 			const char* chunknametarget = detail::make_chunk_name(code, chunkname, basechunkname);
 | |
| 			int index = lua_gettop(L);
 | |
| 			if (luaL_loadbufferx(L, code.data(), code.size(), chunknametarget, to_string(mode).c_str())) {
 | |
| 				lua_error(L);
 | |
| 			}
 | |
| 			set_environment(env, stack_reference(L, raw_index(index + 1)));
 | |
| 			if (lua_pcall(L, 0, LUA_MULTRET, 0)) {
 | |
| 				lua_error(L);
 | |
| 			}
 | |
| 			int postindex = lua_gettop(L);
 | |
| 			int returns = postindex - index;
 | |
| 			return unsafe_function_result(L, (std::max)(postindex - (returns - 1), 1), returns);
 | |
| 		}
 | |
| 
 | |
| 		unsafe_function_result unsafe_script(
 | |
| 		     const string_view& code, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			int index = lua_gettop(L);
 | |
| 			stack::script(L, code, chunkname, mode);
 | |
| 			int postindex = lua_gettop(L);
 | |
| 			int returns = postindex - index;
 | |
| 			return unsafe_function_result(L, (std::max)(postindex - (returns - 1), 1), returns);
 | |
| 		}
 | |
| 
 | |
| 		template <typename E>
 | |
| 		unsafe_function_result unsafe_script_file(const std::string& filename, const basic_environment<E>& env, load_mode mode = load_mode::any) {
 | |
| 			int index = lua_gettop(L);
 | |
| 			if (luaL_loadfilex(L, filename.c_str(), to_string(mode).c_str())) {
 | |
| 				lua_error(L);
 | |
| 			}
 | |
| 			set_environment(env, stack_reference(L, raw_index(index + 1)));
 | |
| 			if (lua_pcall(L, 0, LUA_MULTRET, 0)) {
 | |
| 				lua_error(L);
 | |
| 			}
 | |
| 			int postindex = lua_gettop(L);
 | |
| 			int returns = postindex - index;
 | |
| 			return unsafe_function_result(L, (std::max)(postindex - (returns - 1), 1), returns);
 | |
| 		}
 | |
| 
 | |
| 		unsafe_function_result unsafe_script_file(const std::string& filename, load_mode mode = load_mode::any) {
 | |
| 			int index = lua_gettop(L);
 | |
| 			stack::script_file(L, filename, mode);
 | |
| 			int postindex = lua_gettop(L);
 | |
| 			int returns = postindex - index;
 | |
| 			return unsafe_function_result(L, (std::max)(postindex - (returns - 1), 1), returns);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx,
 | |
| 		     meta::disable_any<meta::is_string_constructible<meta::unqualified_t<Fx>>,
 | |
| 		          meta::is_specialization_of<meta::unqualified_t<Fx>, basic_environment>> = meta::enabler>
 | |
| 		protected_function_result script(
 | |
| 		     const string_view& code, Fx&& on_error, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return safe_script(code, std::forward<Fx>(on_error), chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx,
 | |
| 		     meta::disable_any<meta::is_string_constructible<meta::unqualified_t<Fx>>,
 | |
| 		          meta::is_specialization_of<meta::unqualified_t<Fx>, basic_environment>> = meta::enabler>
 | |
| 		protected_function_result script_file(const std::string& filename, Fx&& on_error, load_mode mode = load_mode::any) {
 | |
| 			return safe_script_file(filename, std::forward<Fx>(on_error), mode);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx, typename E>
 | |
| 		protected_function_result script(const string_view& code, const basic_environment<E>& env, Fx&& on_error,
 | |
| 		     const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return safe_script(code, env, std::forward<Fx>(on_error), chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx, typename E>
 | |
| 		protected_function_result script_file(const std::string& filename, const basic_environment<E>& env, Fx&& on_error, load_mode mode = load_mode::any) {
 | |
| 			return safe_script_file(filename, env, std::forward<Fx>(on_error), mode);
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result script(
 | |
| 		     const string_view& code, const environment& env, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return safe_script(code, env, script_default_on_error, chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result script_file(const std::string& filename, const environment& env, load_mode mode = load_mode::any) {
 | |
| 			return safe_script_file(filename, env, script_default_on_error, mode);
 | |
| 		}
 | |
| 
 | |
| #if SOL_IS_ON(SOL_SAFE_FUNCTION_OBJECTS_I_)
 | |
| 		protected_function_result script(
 | |
| 		     lua_Reader reader, void* data, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return safe_script(reader, data, chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result script(
 | |
| 		     const string_view& code, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return safe_script(code, chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		protected_function_result script_file(const std::string& filename, load_mode mode = load_mode::any) {
 | |
| 			return safe_script_file(filename, mode);
 | |
| 		}
 | |
| #else
 | |
| 		unsafe_function_result script(const string_view& code, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return unsafe_script(code, chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		unsafe_function_result script_file(const std::string& filename, load_mode mode = load_mode::any) {
 | |
| 			return unsafe_script_file(filename, mode);
 | |
| 		}
 | |
| #endif
 | |
| 		load_result load(const string_view& code, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			detail::typical_chunk_name_t basechunkname = {};
 | |
| 			const char* chunknametarget = detail::make_chunk_name(code, chunkname, basechunkname);
 | |
| 			load_status x = static_cast<load_status>(luaL_loadbufferx(L, code.data(), code.size(), chunknametarget, to_string(mode).c_str()));
 | |
| 			return load_result(L, absolute_index(L, -1), 1, 1, x);
 | |
| 		}
 | |
| 
 | |
| 		load_result load_buffer(const char* buff, size_t size, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return load(string_view(buff, size), chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		load_result load_buffer(
 | |
| 		     const std::byte* buff, size_t size, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			return load(string_view(reinterpret_cast<const char*>(buff), size), chunkname, mode);
 | |
| 		}
 | |
| 
 | |
| 		load_result load_file(const std::string& filename, load_mode mode = load_mode::any) {
 | |
| 			load_status x = static_cast<load_status>(luaL_loadfilex(L, filename.c_str(), to_string(mode).c_str()));
 | |
| 			return load_result(L, absolute_index(L, -1), 1, 1, x);
 | |
| 		}
 | |
| 
 | |
| 		load_result load(lua_Reader reader, void* data, const std::string& chunkname = detail::default_chunk_name(), load_mode mode = load_mode::any) {
 | |
| 			detail::typical_chunk_name_t basechunkname = {};
 | |
| 			const char* chunknametarget = detail::make_chunk_name("lua_Reader", chunkname, basechunkname);
 | |
| 			load_status x = static_cast<load_status>(lua_load(L, reader, data, chunknametarget, to_string(mode).c_str()));
 | |
| 			return load_result(L, absolute_index(L, -1), 1, 1, x);
 | |
| 		}
 | |
| 
 | |
| 		iterator begin() const {
 | |
| 			return global.begin();
 | |
| 		}
 | |
| 
 | |
| 		iterator end() const {
 | |
| 			return global.end();
 | |
| 		}
 | |
| 
 | |
| 		const_iterator cbegin() const {
 | |
| 			return global.cbegin();
 | |
| 		}
 | |
| 
 | |
| 		const_iterator cend() const {
 | |
| 			return global.cend();
 | |
| 		}
 | |
| 
 | |
| 		global_table globals() const {
 | |
| 			// if we return a reference
 | |
| 			// we'll be screwed a bit
 | |
| 			return global;
 | |
| 		}
 | |
| 
 | |
| 		global_table& globals() {
 | |
| 			return global;
 | |
| 		}
 | |
| 
 | |
| 		table registry() const {
 | |
| 			return reg;
 | |
| 		}
 | |
| 
 | |
| 		std::size_t memory_used() const {
 | |
| 			return total_memory_used(lua_state());
 | |
| 		}
 | |
| 
 | |
| 		int stack_top() const {
 | |
| 			return stack::top(L);
 | |
| 		}
 | |
| 
 | |
| 		int stack_clear() {
 | |
| 			int s = stack_top();
 | |
| 			lua_pop(L, s);
 | |
| 			return s;
 | |
| 		}
 | |
| 
 | |
| 		bool supports_gc_mode(gc_mode mode) const noexcept {
 | |
| #if SOL_LUA_VERSION_I_ >= 504
 | |
| 			// supports all modes
 | |
| 			(void)mode;
 | |
| 			return true;
 | |
| #endif
 | |
| 			return mode == gc_mode::default_value;
 | |
| 		}
 | |
| 
 | |
| 		bool is_gc_on() const {
 | |
| #if SOL_LUA_VERSION_I_ >= 502
 | |
| 			return lua_gc(lua_state(), LUA_GCISRUNNING, 0) == 1;
 | |
| #else
 | |
| 			// You cannot turn it off in Lua 5.1
 | |
| 			return true;
 | |
| #endif
 | |
| 		}
 | |
| 
 | |
| 		void collect_garbage() {
 | |
| 			lua_gc(lua_state(), LUA_GCCOLLECT, 0);
 | |
| 		}
 | |
| 
 | |
| 		void collect_gc() {
 | |
| 			collect_garbage();
 | |
| 		}
 | |
| 
 | |
| 		bool step_gc(int step_size_kilobytes) {
 | |
| 			// THOUGHT: std::chrono-alikes to map "kilobyte size" here...?
 | |
| 			// Make it harder to give MB or KB to a B parameter...?
 | |
| 			// Probably overkill for now.
 | |
| #if SOL_LUA_VERSION_I_ >= 504
 | |
| 			// The manual implies that this function is almost always successful...
 | |
| 			// is it?? It could depend on the GC mode...
 | |
| 			return lua_gc(lua_state(), LUA_GCSTEP, step_size_kilobytes) != 0;
 | |
| #else
 | |
| 			return lua_gc(lua_state(), LUA_GCSTEP, step_size_kilobytes) == 1;
 | |
| #endif
 | |
| 		}
 | |
| 
 | |
| 		void restart_gc() {
 | |
| 			lua_gc(lua_state(), LUA_GCRESTART, 0);
 | |
| 		}
 | |
| 
 | |
| 		void stop_gc() {
 | |
| 			lua_gc(lua_state(), LUA_GCSTOP, 0);
 | |
| 		}
 | |
| 
 | |
| 		// Returns the old GC mode. Check support using the supports_gc_mode function.
 | |
| 		gc_mode change_gc_mode_incremental(int pause, int step_multiplier, int step_byte_size) {
 | |
| 			// "What the fuck does any of this mean??"
 | |
| 			// http://www.lua.org/manual/5.4/manual.html#2.5.1
 | |
| 
 | |
| 			// THOUGHT: std::chrono-alikes to map "byte size" here...?
 | |
| 			// Make it harder to give MB or KB to a B parameter...?
 | |
| 			// Probably overkill for now.
 | |
| #if SOL_LUA_VERSION_I_ >= 504
 | |
| 			int old_mode = lua_gc(lua_state(), LUA_GCINC, pause, step_multiplier, step_byte_size);
 | |
| 			if (old_mode == LUA_GCGEN) {
 | |
| 				return gc_mode::generational;
 | |
| 			}
 | |
| 			else if (old_mode == LUA_GCINC) {
 | |
| 				return gc_mode::incremental;
 | |
| 			}
 | |
| #else
 | |
| 			lua_gc(lua_state(), LUA_GCSETPAUSE, pause);
 | |
| 			lua_gc(lua_state(), LUA_GCSETSTEPMUL, step_multiplier);
 | |
| 			(void)step_byte_size; // means nothing in older versions
 | |
| #endif
 | |
| 			return gc_mode::default_value;
 | |
| 		}
 | |
| 
 | |
| 		// Returns the old GC mode. Check support using the supports_gc_mode function.
 | |
| 		gc_mode change_gc_mode_generational(int minor_multiplier, int major_multiplier) {
 | |
| #if SOL_LUA_VERSION_I_ >= 504
 | |
| 			// "What does this shit mean?"
 | |
| 			// http://www.lua.org/manual/5.4/manual.html#2.5.2
 | |
| 			int old_mode = lua_gc(lua_state(), LUA_GCGEN, minor_multiplier, major_multiplier);
 | |
| 			if (old_mode == LUA_GCGEN) {
 | |
| 				return gc_mode::generational;
 | |
| 			}
 | |
| 			else if (old_mode == LUA_GCINC) {
 | |
| 				return gc_mode::incremental;
 | |
| 			}
 | |
| #else
 | |
| 			(void)minor_multiplier;
 | |
| 			(void)major_multiplier;
 | |
| #endif
 | |
| 			return gc_mode::default_value;
 | |
| 		}
 | |
| 
 | |
| 		operator lua_State*() const {
 | |
| 			return lua_state();
 | |
| 		}
 | |
| 
 | |
| 		void set_panic(lua_CFunction panic) {
 | |
| 			lua_atpanic(lua_state(), panic);
 | |
| 		}
 | |
| 
 | |
| 		void set_exception_handler(exception_handler_function handler) {
 | |
| 			set_default_exception_handler(lua_state(), handler);
 | |
| 		}
 | |
| 
 | |
| 		template <typename... Args, typename... Keys>
 | |
| 		decltype(auto) get(Keys&&... keys) const {
 | |
| 			return global.get<Args...>(std::forward<Keys>(keys)...);
 | |
| 		}
 | |
| 
 | |
| 		template <typename T, typename Key>
 | |
| 		decltype(auto) get_or(Key&& key, T&& otherwise) const {
 | |
| 			return global.get_or(std::forward<Key>(key), std::forward<T>(otherwise));
 | |
| 		}
 | |
| 
 | |
| 		template <typename T, typename Key, typename D>
 | |
| 		decltype(auto) get_or(Key&& key, D&& otherwise) const {
 | |
| 			return global.get_or<T>(std::forward<Key>(key), std::forward<D>(otherwise));
 | |
| 		}
 | |
| 
 | |
| 		template <typename... Args>
 | |
| 		state_view& set(Args&&... args) {
 | |
| 			global.set(std::forward<Args>(args)...);
 | |
| 			return *this;
 | |
| 		}
 | |
| 
 | |
| 		template <typename T, typename... Keys>
 | |
| 		decltype(auto) traverse_get(Keys&&... keys) const {
 | |
| 			return global.traverse_get<T>(std::forward<Keys>(keys)...);
 | |
| 		}
 | |
| 
 | |
| 		template <typename... Args>
 | |
| 		state_view& traverse_set(Args&&... args) {
 | |
| 			global.traverse_set(std::forward<Args>(args)...);
 | |
| 			return *this;
 | |
| 		}
 | |
| 
 | |
| 		template <typename Class, typename... Args>
 | |
| 		usertype<Class> new_usertype(Args&&... args) {
 | |
| 			return global.new_usertype<Class>(std::forward<Args>(args)...);
 | |
| 		}
 | |
| 
 | |
| 		template <bool read_only = true, typename... Args>
 | |
| 		state_view& new_enum(const string_view& name, Args&&... args) {
 | |
| 			global.new_enum<read_only>(name, std::forward<Args>(args)...);
 | |
| 			return *this;
 | |
| 		}
 | |
| 
 | |
| 		template <typename T, bool read_only = true>
 | |
| 		state_view& new_enum(const string_view& name, std::initializer_list<std::pair<string_view, T>> items) {
 | |
| 			global.new_enum<T, read_only>(name, std::move(items));
 | |
| 			return *this;
 | |
| 		}
 | |
| 
 | |
| 		template <typename Fx>
 | |
| 		void for_each(Fx&& fx) {
 | |
| 			global.for_each(std::forward<Fx>(fx));
 | |
| 		}
 | |
| 
 | |
| 		template <typename T>
 | |
| 		table_proxy<global_table&, detail::proxy_key_t<T>> operator[](T&& key) {
 | |
| 			return global[std::forward<T>(key)];
 | |
| 		}
 | |
| 
 | |
| 		template <typename T>
 | |
| 		table_proxy<const global_table&, detail::proxy_key_t<T>> operator[](T&& key) const {
 | |
| 			return global[std::forward<T>(key)];
 | |
| 		}
 | |
| 
 | |
| 		template <typename Sig, typename... Args, typename Key>
 | |
| 		state_view& set_function(Key&& key, Args&&... args) {
 | |
| 			global.set_function<Sig>(std::forward<Key>(key), std::forward<Args>(args)...);
 | |
| 			return *this;
 | |
| 		}
 | |
| 
 | |
| 		template <typename... Args, typename Key>
 | |
| 		state_view& set_function(Key&& key, Args&&... args) {
 | |
| 			global.set_function(std::forward<Key>(key), std::forward<Args>(args)...);
 | |
| 			return *this;
 | |
| 		}
 | |
| 
 | |
| 		template <typename Name>
 | |
| 		table create_table(Name&& name, int narr = 0, int nrec = 0) {
 | |
| 			return global.create(std::forward<Name>(name), narr, nrec);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Name, typename Key, typename Value, typename... Args>
 | |
| 		table create_table(Name&& name, int narr, int nrec, Key&& key, Value&& value, Args&&... args) {
 | |
| 			return global.create(std::forward<Name>(name), narr, nrec, std::forward<Key>(key), std::forward<Value>(value), std::forward<Args>(args)...);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Name, typename... Args>
 | |
| 		table create_named_table(Name&& name, Args&&... args) {
 | |
| 			table x = global.create_with(std::forward<Args>(args)...);
 | |
| 			global.set(std::forward<Name>(name), x);
 | |
| 			return x;
 | |
| 		}
 | |
| 
 | |
| 		table create_table(int narr = 0, int nrec = 0) {
 | |
| 			return create_table(lua_state(), narr, nrec);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Key, typename Value, typename... Args>
 | |
| 		table create_table(int narr, int nrec, Key&& key, Value&& value, Args&&... args) {
 | |
| 			return create_table(lua_state(), narr, nrec, std::forward<Key>(key), std::forward<Value>(value), std::forward<Args>(args)...);
 | |
| 		}
 | |
| 
 | |
| 		template <typename... Args>
 | |
| 		table create_table_with(Args&&... args) {
 | |
| 			return create_table_with(lua_state(), std::forward<Args>(args)...);
 | |
| 		}
 | |
| 
 | |
| 		static inline table create_table(lua_State* L, int narr = 0, int nrec = 0) {
 | |
| 			return global_table::create(L, narr, nrec);
 | |
| 		}
 | |
| 
 | |
| 		template <typename Key, typename Value, typename... Args>
 | |
| 		static inline table create_table(lua_State* L, int narr, int nrec, Key&& key, Value&& value, Args&&... args) {
 | |
| 			return global_table::create(L, narr, nrec, std::forward<Key>(key), std::forward<Value>(value), std::forward<Args>(args)...);
 | |
| 		}
 | |
| 
 | |
| 		template <typename... Args>
 | |
| 		static inline table create_table_with(lua_State* L, Args&&... args) {
 | |
| 			return global_table::create_with(L, std::forward<Args>(args)...);
 | |
| 		}
 | |
| 	};
 | |
| } // namespace sol
 | |
| 
 | |
| #endif // SOL_STATE_VIEW_HPP
 |