https://github.com/Rapptz/sol

A C++11 Lua wrapper
https://github.com/Rapptz/sol

Last synced: 8 days ago
JSON representation

A C++11 Lua wrapper

• Host: GitHub
• URL: https://github.com/Rapptz/sol
• Owner: Rapptz
• License: mit
• Created: 2013-11-25T09:59:34.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2016-02-12T03:36:08.000Z (over 8 years ago)
• Last Synced: 2024-10-12T09:10:48.869Z (23 days ago)
• Language: C++
• Homepage:
• Size: 1.19 MB
• Stars: 208
• Watchers: 26
• Forks: 32
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
## Sol

[![Build Status](https://travis-ci.org/Rapptz/sol.svg?branch=master)](https://travis-ci.org/Rapptz/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

```cpp

#include 

#include 

int main() {

    sol::state lua;

    int x = 0;

    lua.set_function("beep", [&x]{ ++x; });

    lua.script("beep()");

    assert(x == 1);

}

```

```cpp

#include 

#include 

struct vars {

    int boop = 0;

};

int main() {

    sol::state lua;

    lua.new_userdata("vars", "boop", &vars::boop);

    lua.script("beep = vars.new()\n"

               "beep.boop = 1");

    assert(lua.get("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 `.

## License

Sol is distributed with an MIT License. You can see LICENSE.txt for more info.