Lua To Lua C Online Game
Lua To Lua C Converter
Lua To Lua C Converter

wiki

Further complicating things is that with every major version of Lua, the method of calling Lua from C changes. Much documentation on the Internet is specific to Lua 5.0, and won't work on 5.1. Likewise, this documentation is specific to 5.1, and when 5.2 comes out (it's alpha right now), the documentation on this page won't work on the new version. Lua is a pretty straight forward simple scripting language that can be implemented in a number of languages. Today I’m going to show you how easy it is to embed Lua in C. First thing you’re going to need to do is create a sane build environment by installing the Lua programming language and development packages.

lua2c is a Lua module and utility to convert Lua 5.1 source code to C API code.

Description

This utility converts a given Lua source file into an equivalent C source file written in terms of Lua C API calls. At least, this works for a large subset of the Lua language (see limitations below).

The compiler is written entirely in Lua, and no build/install is needed. This project reuses Metalua's gg/mlp parser to convert Lua source to a Metalua-style [1] AST over which the compiler then operates. lua2c does not require Metalua itself though since gg/mlp is bundled in the distribution (patched metalua-0.4.1-rc1) and is written in pure Lua.

Usage

Example usage:

which generates a C file similar to as shown here: [bisect.c].

You may also use the shell script 'clua' to compile Lua->C->machine code and execute all in one step. However, you may need to edit the variables in the file to match your system since this utility invokes the C compiler.

lua2c can even compile itself! (Note: the -c option compiles only without running.)

Related Work

luac2c - This related effort by Hisham Muhammad [2] converts Lua bytecodes to C source, whereas this project converts Lua source to C source. luac2c runs into a few similar limitations as given below. luac2c has remained experimental but superseded Luiz Henrique De Figueiredo's very basic but similarly named lua2c for Lua 4.0 [3].

luagen++ [4] uses C++ expression templates to translate Lua-like C++ statements to C API calls. Some of the code generation structure is actually fairly similar to lua2c.

Python Pyrex [5] does something similar in Python but has the added goal of lowering the boundary between C and Python code. Something like that could be done with lua2c, especially since lua2c uses the extensible gg parser.

Clue by David Given [6] does the opposite: convert C source to Lua source.

luac + BinToCee [10] allow compilation of Lua source to bytecodes and/or embedding in a C file.

LuaInterpreterInLua [12] - is the Lua interpreter (lua.c) reimplemented in Lua. It can be compiled to C via lua2c (e.g. for scaffolding).

Potential Uses

I think this project not only is theoretically nice to have but has a number of potential uses:

Provide another approach of compiling Lua to machine code (rather than luac + BinToCee).
Streamline the interface between C and Lua code and allow efficient access to C datatypes from Lua (see Pyrex above).
Compile Lua to optimized C. For example, by statically determining that certain variables are used in a restricted way (e.g. by decorating the Lua source file with pragmas or determining this implicitly by inference), certain code constructs might be simplified to use plain C rather that the Lua C API. This could allow certain Lua code written with sufficient care to run at native speeds. Since it compiles to C, it will even work on CPUs where LuaJIT is not available.

Limitations

WARNING: This code passes much of the Lua 5.1 test suite [7] and can compile itself, but the code is new and there can still be errors. In particular, a few language features (e.g. coroutines) are not implemented. See comments in lua2c.lua for details. Please report bugs/patches on the wiki.

lua2c does not currently support coroutines, functions that normally reject C functions (e.g. setfenv), and possibly tail call optimizations. Not all of these have the exact analogue in C. Coroutines might not ever be supported. However, some solutions might be explored [8][9], including possibly generating code that maintains the coroutine context in Lua tables.

Closures and upvalues are implemented, but creating and accessing upvalues is somewhat slow due to the implementation (see implementation notes below) and hopefully can be improved.

Now that the code is fairly complete/robust, more attention can be given to optimizing the code generation. Performance was 25%-75% of regular Lua when running a few tests [11], but hopefully future optimizations will improve that.

Lua 5.2 Notes

LuaFiveTwo (as of 5.2.0-work4) deprecates getfenv and setfenv, which eliminates one of the limitations above.
LuaFiveTwo has new lua_arith and lua_compare C API functions, which eliminate the need for lua2c to reimplement these functions.
LuaFiveTwo also has new lua_yieldk, lua_callk, and lua_pcallk functions for coroutines and might help to implement coroutines in lua2c.
lua2c might implement upvalues as C function upvalues rather than tables, given LuaFiveTwo implements lua_upvaluejoin/lua_setupvalue/lua_setupvalue, so C functions can share upvalues directly.
Concerning tail calls, see [1].

Download

Latest development source (recommended): http://github.com/davidm/lua2c/ . From here you can browse the source, download a tar/zip snapshot, or checkout with git by running 'git clone git://github.com/davidm/lua2c.git'.
Last release distribution: [lua2c-0.2.1-20080802.tar.gz]; Older versions: [achive]

Project Page

The project page is currently http://lua-users.org/wiki/LuaToCee .

Author

Licensing

Implementation Notes

Some implementation notes will likely go here.

Important topics include

Implementing closures with upvalues in C. The current approach is to store local variables that are used as upvalues in a Lua table scoped to the block (lc_newclosuretable). Utility functions lc_getupvalue/lc_setupvalue access it.
Supporting vararg (...) functions. Mainly, this just requires allowing the stack to be shifted by an arbitrary amount (lc_nextra).
The transformation process: Lua code string -> Lua AST -> C AST -> C code string
Implementation of utility functions not in the Lua C API (e.g. arithmetic metamethod handlers, such as lc_add to implement __add to add two numbers while handling metamethods).
Keeping track of lexical scope (currentscope table)
Keeping track of the stack (idxtop)
Handling expressions that evaluate to 0, 1, or multiple return values
Handling expressions not on the top of the stack (where is 'onstack' v.s. 'anywhere')
Constant folding
Possible optimization tricks (not yet implemented):
- Removing metamethods calls when it can be inferred they won't be triggered.
- Other code elimination.
- Using internal interfaces rather than the C API?
- Building constant tables?
- Inlining?

Future Work

This project could be significantly helped by the addition of a global (per-file) code optimizer. Most importantly, some type of interprocedural data flow analysis[2] could infer the basic data types of many expressions in code (e.g. this value is a number, has no metatable, is a constant with a certain value, or is positive), especially when that code makes extensive use of local (lexical) variables. Alternately, special comments ('--!' like in LuaInspect) could be supported to allow the programmer to inject this information. If the AST is decorated with this information, the code generator could replace generic code with more specific code. For example, the Lua code 'a+b' normally translates to values a and b on the Lua stack, with __add metamethod look

Lua To Lua C Online