luwra/docs/mkdocs/wrapping.md

General

Luwra provides an easy way to turn any C or C++ function into a lua_CFunction which can be used by the Lua VM. Note, all parameter types must be readable from the stack (Value<T>::read exists for all) and the return type must be pushable (Value<T>::push exists).

Wrap C/C++ functions

Assuming you have a function similiar to this:

int my_function(const char* a, int b) {
    return /* magic */;
}

You can easily wrap it using the LUWRA_WRAP macro:

// Convert to lua_CFunction
lua_CFunction cfun = LUWRA_WRAP(my_function);

// Do something with it, for example set it as a Lua global function
luwra::setGlobal(lua, "my_function", cfun);

Note: Do not provide the address of your function (e.g. &my_function) to any wrapping macro. The macros will take care of this themselves. You must provide only the name of the function.

Calling the function from Lua is fairly straightforward:

local my_result = my_function("Hello World", 1337)
print(my_result)