Sol 是一个C++ 绑定lua的库,当前支持 Lua5.1以上的版本(包含LuaJit2.0).Sol的目的是使用起来简单,并且容易添加进工程。这个库是只有头文件的,所以很容易集成到工程中。
快速预览
#include <sol.hpp>
#include <cassert>
int main() {
sol::state lua;
int x = 0;
lua.set_function("beep", [&x]{ ++x; });
lua.script("beep()");
assert(x == 1);
}
#include <sol.hpp>
#include <cassert>
struct vars {
int boop = 0;
};
int main() {
sol::state lua;
lua.new_usertype<vars>("vars", "boop", &vars::boop);
lua.script("beep = vars.new()\n"
"beep.boop = 1");
assert(lua.get<vars>("beep").boop == 1);
}
使用单独一个头文件
运行 single.py 脚本 可以获取一个单独的头文件, single.py –help 获取更多信息
特性
- 出众的运行速度 性能测试
- 支持获取和设置多种数据类型,包括 std::string std::map,std::unordered_map.
- 支持Lambda,全局函数/静态成员函数,成员函数的绑定
- 运行期间类型检查
- 简单的封装C stack API, 包含
protected_function
可以使用储物处理函数 - operator[] 风格的操作 table
- C++ 类型在lua中使用userdata 表示,Sol中的
usertype
,并且确保对象的释放 - 自定义的功能可以使你的C++对象从lua中push和pop
- 支持导出函数 在lua中重载
- 支持 tables,嵌套table,和使用迭代器遍历table
支持的编译器
Sol 使用 C++11/14 特性. GCC4.9 和 Clang3.4 (使用std=C++1z连接标准库) ,或者更高的版本,使用sol应该没有问题。然而官方支持和测试使用的版本有:
- GCC 4.9.0+
- Clang3.5+
- Visual Studio 2015 Community (Visual C++ 14.0)+
许可
MIT License