mirror of
https://github.com/ThePhD/sol2.git
synced 2024-03-22 13:10:44 +08:00
875 lines
31 KiB
C++
875 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
|