tcc.new ()

Returns a new TCC compiling context. This context can be used to compile C code and dynamically execute it.

     local context = tcc.new()

context:add_include_path (path)

Adds an include path to the context. #include directives in compiled sources will look for header files in paths provided by that function and some system-wide paths defined when compiling TCC.

context:compile (source [, chunkname])

Compiles a C source file inside the context. Optionnal chunkname argument can be a string that will be displayed in error messages (typically it will be the source file from which source is extracted, if any).

     context:compile[[
          #include <lua.h>
          int hello(lua_State* L)
          {
               lua_pushstring(L, "Hello World!");
               return 1;
          }
     ]]

context:add_library_path (path)

Adds a library path to the context. context:add_library will look for libraries in the paths provided by that function and in some system-wide paths defined when compiling TCC.

context:add_library (libraryname)

Adds a library to the context. This can be used to load static libraries or import libraries for dynamically loaded libraries. libraryname is the short name of the library (for example short name of liblua51.a is "lua51").

context:relocate ()

Performs the actual linking of the compiled sources and libraries present in the context. This function returns nothing, to access externally accessible symbols from the linked code use context:get_symbol.

     context:relocate()

context:get_symbol (symbolname)

This function looks for a symbol in the compiled code present in the context. The symbol is cast to a lua_CFunction, and returned as a function. You have to make sure that the symbol matches lua_CFunction, otherwise calling the returned function has unexpected behaviour (which is likely to be a crash).

     local hello = context:get_symbol("hello")
     print(hello()) -- Should output "Hello World!"