bd4492b85b
sol::object had a few reference leaks in the way it retrieved values: it now does it properly without leaving the stack at +1 item
sol::stack was drastically cleaned up, with the following key change:
* sol::stack::push now returns an integer of the number of things its pushed (usually 1, but can be more) (Thanks, @PrincessNyanara!)
* sol::stack::call now calls functions flexibly, and getting is done more reliably
* due to the innovation of stack::call and using absolute indices, we no longer have to use reverse_call style programming to deal with lua
* sol::reference::get_type is now const-correct
* sol::state and sol::table now have a cleaned up `get` implementation since it is no longer held back by the ugliness of VC++'s incapability to handle templates
* the name `sol::userdata` now belongs to a type that actually encapsualtes a void* with a pusher/getter than gets a userdata void* value (TODO: give it a template to make it static_cast to that type on get?)
* lightuserdata_t -> light_userdata, upvalue_t -> upvalue as type names (mostly details)
* pushers for various types were updated to return integers
|
||
|---|---|---|
| Catch@a6d74bd55a | ||
| examples | ||
| sol | ||
| .gitignore | ||
| .gitmodules | ||
| .travis.yml | ||
| bootstrap.py | ||
| CONTRIBUTING.md | ||
| LICENSE.txt | ||
| ninja_syntax.py | ||
| README.md | ||
| sol.hpp | ||
| tests.cpp | ||
Sol
Sol is a C++ library binding to Lua. It currently supports Lua 5.2. Sol aims to be easy to use and easy to add to a project. At this time, the library is header-only for easy integration with projects.
Sneak Peek
#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_userdata<vars>("vars", "boop", &vars::boop);
lua.script("beep = vars.new()\n"
"beep.boop = 1");
assert(lua.get<vars>("beep").boop == 1);
}
More examples are given in the examples directory.
Features
- Supports retrieval and setting of multiple types including
std::string. - Lambda, function, and member function bindings are supported.
- Intermediate type for checking if a variable exists.
- Simple API that completely abstracts away the C stack API.
operator[]-style manipulation of tables is provided.- Support for tables.
Supported Compilers
Sol makes use of C++11 features. GCC 4.7 and Clang 3.3 or higher should be able to compile without problems. However, the officially supported compilers are:
- GCC 4.8.0
- GCC 4.9.0
- Clang 3.4
Visual Studio 2013 with the November CTP could possibly compile it, despite not being explicitly supported. The last
version that Visual Studio 2013 was supported was on tag v1.1.0. Anything after that is wishful thinking. In order to
retrieve that tagged version, just do git checkout v1.1.0.
Caveats
Due to how this library is used compared to the C API, the Lua Stack is completely abstracted away. Not only that, but all Lua errors are thrown as exceptions instead. This allows you to handle the errors gracefully without being forced to exit.
It should be noted that the library itself depends on lua.hpp to be found by your compiler. It uses angle brackets, e.g.
#include <lua.hpp>.
License
Sol is distributed with an MIT License. You can see LICENSE.txt for more info.