tolua++

一.tolua++简介
      tolua++是一种第三方的软件包,可以为Lua提供面向对象的特性,这样我们就可以使用Lua来编写使用C++语言库的脚本文件.

二.tolua++的编译.
     tolua++的主页在 http://www.codenix.com/~tolua/ ,目前的最新版本是1.0.7,为了使用tolua++,我们需要三个文件:
        1.bin/tolua++[.exe] - tolua++的可执行程序
        2.include/tolua++.h - tolua++的头文件
        3.lib/libtolua++.a or lib/tolua++.lib - tolua++的静态库(当然有的时候也需要生成动态库,可以参考我下面给出的文章的网址,我们先从最简单的入手)
       使用tolua++的时候,都需要使用tolua++的可执行程序自动生成一个.pkg文件生成对应的.c(C语言)或者.cpp文件(C++语言),然后把这个文件和对应的C/C++文件一起编译生成可执行程序,这样就可以对对应的Lua脚本进行读取操作.在后面将结合代码例子对这个过程进行详细的讲解.

        tolua++的编译比较麻烦,官方的编译说明需要scons这个软件,下面介绍另一种办法,只需要Lua就可以了(本身编写Lua脚本文件不可能不用到Lua解释器,所以这个算不上什么负担了:)
       说明一下,这个办法不是我想出来的,出处在这里:
        http://lua-users.org/wiki/CompilingToluappWithoutScons
       官方下载的tolua++文件夹里面已经有了上面提到的1和2文件了,我在这里偷懒,就只说3的生成.
       其实在上面的文档里面写得很清楚了,如下编译生成静态库文件:     

tolua ++ _1. 0.5 - 1 /src/lib >  gcc  - c  * .c   - I../../include  - I  < path_to_lua > /include
tolua ++ _1. 0.5 - 1 /src/lib >  ar rcsv libtolua ++ .a  * .o

      
        <path_to_lua>的意思是这里输入的是lua源代码包的路径,gcc中的-I参数用于指定include文件的位置.
       生成了这三个文件之后,如果需要使用它们的话,需要把它们拷贝到相应的路径.windows下面一般的会使用cygwin这个工具,以它为例说明:
1.可执行文件放在cygwin根目录的bin目录下
2.头文件放在cygwin根目录下的usr/include下面
3.静态头文件放在cygwin根目录下的lib目录下面
说明:如果没有Lua语言的对应的可执行文件,头文件,lib文件一样不能使用tolua++,对于配置lua脚本解释器的过程和上面类似.
OK,这样一个tolua++的编译环境就配制好了,如果你在原先安装cygwin的时候没有指定cygwin的可执行文件的目录,那么对于windows下面的用户可以在"我的电脑"-"属性"-"高级"-"环境变量"-"Path"里面修改,
比如我在里面加入我的cygwin的bin目录:C:/cygwin/bin,大功告成~~windows下面的用户只用gcc的话不一定非得使用cygwin,毕竟太大了,有人喜欢使用mingw,配置的方法类似~~

三.代码例子
        tolua++的源码包下载下来之后在根目录的src/tests中有很多代码例子,我们随便找其中的tarray一组作为讲解的对象.

        这一组中包含的有对应的pkg文件,c文件,h文件和最后用于测试的lua脚本文件.pkg文件是用于声明我们允许后来使用的Lua脚本使用的变量,常量,类,函数等等的一个声明列表,这个列表中的所有东西都必须在对应的C++文件中给出来,不然是无法使用的.pkg文件的语法和C/C++的语法比较类似,可以到tolua++的官方网站上去看看,这里不再详述.
        使用pkg文件我们可以生成一个对应的C或者C++文件,可以这样做:

tolua ++   - o test.c tarray.pkg

        生成的test.c就是对应的c文件,你打开这个文件看看,基本上都需要上千行的代码.

        打开tarray.c看看,为了使用Lua我们还需要作些什么,除去基本的数据的定义和main之外,还需要这些:
1.包含lua头文件:

#include  " lualib.h "
#include  " lauxlib.h "

2.调用Lua脚本:
省略去不重要的部分,有这些代码:

  int   tolua_tarray_open (lua_State * );
 lua_State *  L  =  lua_open();
  // .
 luaopen_base(L);
 tolua_tarray_open(L);
 lua_dofile(L, " tarray.lua " ); // 执行lua脚本
 lua_close(L);

 

        OK,现在来看看如何使用:
       首先,生成tarray.o文件:

gcc tarray.c  - c

       其次,生成test.o文件:

gcc test.c tarray.h  - c

       最后,把两个文件链接起来,注意要加入Lua和tolua++的lib文件:

gcc  - o tarray.exe tarray.o test.o  - llua  - llualib  - ltolua ++

       好了,现在大功告成,我们编写一段Lua代码调用C中的变量(源码中带有的tarray.lua基本上没有任何用途:)

for  i = 1 , 10   do
   print(a[i  -   1 ])
end

for  i = 2 , 10   do
   print(p[i  -   1 ].x)
end

      OK,现在在命令行下面输入tarray.exe看看效果:

1
2
3
4
5
6
7
8
9
10
1
2
3
4
5
6
7
8
9

      可以看到简单的两个循环遍历C中的变量的效果就这样由lua脚本实现了,很简单,不是么:)

       总结一下使用tolua++的过程:
        1)编写pkg文件生成对应的c/c++文件
        2)分别编译1)产生的文件(注意要加上对应的头文件)和需要使用lua脚本的文件
        3)编写lua脚本,遵从lua的语法并且使用到的变量,函数,类等都是1)中声明过的.