How to embed Lua 5.1 in C++

June 7th, 2008 mysurface Posted in Developer, Lua | Hits: 70445 | 3 Comments »

Lua, is a scripting language providing dynamic data structures, maths, io and string manipulations just like any interprete language such as Bash, Python, Ruby etc.

What is so special about Lua?
Lua is Fast, Light-weight and Embeddable.

Lua can be embedded into c and c++ programs and Lua core are statically complied with your c++ programs, meaning your c++ program itself are now becoming Lua interpreter that execute Lua scripts. To extend your c++ application to execute Lua script is simple, lets check it out.

Before you start, please download and install Lua from HERE.
Disclaimer: My example are based on Lua 5.1.3.

1. Create a simple Lua script and name it as foo.lua.

io.write("Please enter your name: ")
name = -- read input from user
print ("Hi " .. name .. ", enjoy hacking with Lua");

2. Write a cpp program clua.cpp to execute foo.lua.

extern "C" {
#include "lua.h"
#include "lualib.h"
#include "lauxlib.h"

int main()
    int s=0;

    lua_State *L = lua_open();

    // load the libs

    //run a Lua scrip here

    printf("\nI am done with Lua in C++.\n");


    return 0;

Lua API are in c format, in order to make it work with C++ you need to extern “C”. luaL_openlibs(L) loading up all the basic libs such as IO, String, Math etc. I believe if you are using Lua 5.0, you have to replace luaL_open(L) to load the libs one by one like this:


3. Compile the clua.cpp with g++.

g++ -o clua{,.cpp} -llua -ldl

IMPORTANT! You need to link you program with libdl besides liblua. I believe the use of luaL_openlibs() are calling dlopen, dlclose, dlerror, dlsym which needs libdl.

Else you may get linking error like this:

/usr/local/lib/liblua.a(loadlib.o): In function `ll_loadfunc':
loadlib.c:(.text+0x917): undefined reference to `dlsym'
loadlib.c:(.text+0x924): undefined reference to `dlerror'
loadlib.c:(.text+0x9fc): undefined reference to `dlopen'
loadlib.c:(.text+0xa11): undefined reference to `dlerror'
/usr/local/lib/liblua.a(loadlib.o): In function `gctm':
loadlib.c:(.text+0x101e): undefined reference to `dlclose'
collect2: ld returned 1 exit status

4. Execute your c++ app

$ ./clua
Please enter your name: surface
Hi surface, enjoy hacking with Lua

I am done with Lua in C++.

Cool isn’t it?

Lets try to change foo.lua into this:

io.write("Please enter your name: ")
name =
io.write("Hi " .. string.format("\27\91\1;38;40m%s\27\91\0;47;40m",name) .. ", enjoy hacking with Lua\n");

Now, run ./clua again! You name will be in RED, check out text color example HERE

Ofcause, in order to really extend your c++ apps to Lua script, you need more than lua_dofile(), you need to allow Lua script calling your c++ functions, you may need to access variables from Lua to c++ and vice versa. Well, mean while I am still learning, I will share more when I learn more tricks!

Reference and Tutorial!
Lua provides excellent documentation:

  • 1. Lua Reference Manual
  • 2. Ebook: Programming in Lua
  • I am dilemma here whether should I post this at or As an introduction post for Lua programming, I will put it on both blogs. For future post, if I write about Lua scripting, I will post at and if I write about Lua C++ API, it will be at

    Hope you enjoy this post, and start to script with Lua.
    @lightstar: In case you are reading this, I would like to say thank you for introduce this wonderful language to me, I enjoy it very much!

    3 Responses to “How to embed Lua 5.1 in C++”

    1. kapsiaoloong Says:

      Nice to play with but friend can show more application example ar ? Like maybe start a project to build some lite apps with lua ??? can ? can ?

    2. @lionelSo Pidjin is a bit disrespectful to gays, but you dont have to be a drama queen about it..Im sure not all the characters in this comic share Pidjins views, so lighten up..Would it have been better if we had gone with the title Equal Opportunity Invader ? Also Pidjin could have said such a fairy but his small black heart is far too hateful for that.

    3. teachkec wordpress com 2014 11 05 rationale for teaching mathematics grant mcwalter

    Leave a Reply