Question 1

How do I bind a C++ class to Lua using luacxx?

Accepted Answer

You need to define a metatable and specialize conversion templates, typically across multiple files. The example in 'examples/003-counter-binding' shows separating the C++ class, binding declaration, and implementation, using macros for metatable setup and methods.

Question 2

Luacxx vs sol2: which is better for my project?

Accepted Answer

Luacxx offers more control and direct Lua API access with a C++20 focus, while sol2 provides higher-level abstractions and might be easier for quick bindings. Choose Luacxx if you need fine-grained control and modern C++ features; opt for sol2 for convenience and a more opinionated approach.

Question 3

Does luacxx support Lua 5.4?

Accepted Answer

Yes, luacxx requires Lua 5.2 or newer, so it is fully compatible with Lua 5.4. The library interacts directly with the Lua C API, ensuring support for recent versions without additional modifications.

Question 4

How to handle errors when Lua code fails in luacxx?

Accepted Answer

Luacxx provides mechanisms for catching and throwing 'lua::error' exceptions. The documentation in 'docs/guide/handling-lua-errors.md' covers inspecting errors, managing stack traces, and integrating error handling into C++ code.

Question 5

Can I use luacxx without CMake in my project?

Accepted Answer

While designed for CMake, luacxx installs a pkg-config file, allowing use in other build systems. However, integration might require manual setup, such as linking libraries and including headers, which is less streamlined than the CMake approach.

Question 6

What C++ standard library types are supported out of the box?

Accepted Answer

Luacxx includes built-in conversions for std::string, std::vector, std::map, std::optional, std::shared_ptr, std::tuple, and others, as listed in the conversions section. This enables seamless data exchange without additional code for common types.

luacxx

What is luacxx?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions