这几天研究了一下lua,主要关注的是lua和vc之间的整合,把代码都写好放在VC宿主程序里,然后在lua里调用宿主程序的这些代码(或者叫接口、组件,随便你怎么叫),希望能用脚本来控制主程序的行为。这实际上也是一种把业务分离,用脚本控制的架构,可能有些人把这种脚本叫做业务引擎,工作流等。
为什么选择lua?
因为它是一个能和C/C++结合得很紧的脚本语言,而我们的程序是用VC++ 写的;另外一点是因为它的名气,连WOW都用lua来提供API让玩家修改其游戏行为,那我是找不到什么理由拒绝它了。
Lua是什么?在哪里获取LUA?
详细的不说了,在网上一搜大把,只说一下它的官网吧:www.lua.org,在这里可以查到lua的应用,lua发布的版本,我用的是5.1.4,下载的是源代码的版本。
LUA和VC MFC的整合?
- 1、 包含LUA:要使用LUA,当然要先把它包含进我们的工程里,可以有lib/dll方式、也可以用静态lib方式,当然也可以把整个lua的代码放进我们的工程,然后编译,因为lua只有几百K,很小。。。包含整个代码的方法我说一下:
- a) 在VC MFC新建一个工程(例如Dialog base工程)
- b) 去到工程里的文件tab页,新建一个文件夹,然后把所有lua里的.c、.h文件包含进来,注意有几个不用包含,lua.c、wmain.c、luac.c,包含进来之后,选中这个文件夹下面的所有.c文件,然后右键选setting,选择Not using precompiler file,具体自己找找哈。这步做完就马上编译一下,应该是没问题的了!
- c) 还有动态库和静态lib两种方式把lua包含进工程里的,自己可以尝试一下。
- 2、 在某个地方(我是在MFCLua1Dlg.cpp文件开始处)包含lua的头文件,并声明一个lua_state指针,如下:
extern "C" { #include "lua.h" #include "lualib.h" #include "lauxlib.h" } lua_State *lua;
在某个适当的地方(我是在OnInitDialog里)调用下面一段代码,这段代码的作用是打开一些必要的库:
lua = lua_open (); if(lua) { luaopen_base (lua); luaopen_table (lua); luaopen_string (lua); luaopen_math (lua); luaopen_debug (lua); //luaopen_io (lua); }
用完lua的时候,调用下面一句来关闭lua库:
lua_close (lua);
好了,到现在为止,lua已经完全变成我们程序的一部分了,试着编译一下,看看能不能顺利通过。。。
LUA和MFC的交互?
Lua变成我们程序的一部分之后,我们还要使用它,要记住我们的目标是用脚本程序控制我们宿主程序的执行流程,那我们就要完成两步,一是用mfc程序调用lua的函数,二是用lua调用mfc的函数,下面的内容对于初学者可能会开始有点难理解了,请打醒十二分精神,我会尽量简单的说。。。
1、 mfc调用lua的函数,这里用到一个StackDump的函数,是关于主程序和lua的交互栈的问题,下面会对交互栈的问题专门说明。
首先我们用记事本建立一个test.lua,内容是一个相加函数:
function add ( x, y ) return x + y; end
然后再VC里调用它,如下的一段代码,看这段代码的时候,先把StackDump函数忽略,只需要知道它是一个输出lua和vc交互栈内容的函数,对了,你可以新建一个button的click函数,然后把这段代码放进去:
StackDump(lua); luaL_dofile(lua, "test.lua"); // 解释分析lua文件 StackDump(lua); lua_getglobal(lua, "add"); // 取到一个全局标号add,取的同时会把add函数压栈 StackDump(lua); lua_pushnumber(lua, ); // 把第一个参数压入栈里 StackDump(lua); lua_pushnumber(lua, ); // 第二个参数压栈 StackDump(lua); //lua_call(lua, 2, 1); if(lua_pcall(lua, , , ) != ) // 执行add函数 { AfxMessageBox("lua_pcall error!"); return; } StackDump(lua); int d = (int)lua_tonumber(lua, -); // 函数执行完了,执行结果被压栈,所以取得最顶端的一个数就是结果值,-1就是指取栈顶的值 CString str; str.Format("%d", d); AfxMessageBox(str); StackDump(lua); lua_pop(lua, ); // 把值从栈里清除,pop(弹出)一个值 StackDump(lua);
好好分析一下这段代码,我们大概知道调用lua函数的一个过程是:dofile--〉函数名压栈--〉参数依序压栈--〉lua_pcall执行(执行结果压栈)--〉取出执行结果(如果有多个,就从栈里取出多个。。。),这样我们就能很轻松的调用到lua里的函数,其实就是要知道栈里发生了什么。。。
2、 lua调用MFC函数,比如我们想在lua里调用一个Msg函数,能弹出一个窗口来显示我们想显示的字串,然后返回值是1个"MsgOK!"字串。
lua文件是这样的,第一句是调用Msg函数,第二句是测试返回的字串是不是"MsgOK!":
c = Msg (""); Msg(c);
MFC程序里是这样的:
首先写一个将要被导出的函数,很多文章叫它为粘合函数(glue function):
static int Msg(lua_State* L) { const char *s1 = luaL_checkstring(L, ); // 测试第一个参数是否为字串形式,并取得这个字串 StackDump(L); MessageBox(NULL, s1, "caption", MB_OK); lua_pop(lua, ); // 清除栈里的这个字串 StackDump(L); lua_pushlstring(L, "MsgOK!", ); // 把返回值压进栈里 // 这个返回是指返回值的个数 return ; }
然后就导出这个函数,如下:
lua_pushcfunction(lua, Msg);
lua_setglobal(lua, "Msg");
接着就执行刚才的lua文件就行了,记得执行之前要先lua_open () 哦:
luaL_dofile(lua, "test.lua");
运行的结果就是连续跳出两个messagebox,第一个是123,第二个是"MsgOK!",说明我们返回的字串被lua接收到了,lua的第二行我们没有接收它的返回值,则这个返回值会自动被抛弃了。
如果需要多返回值,则我们要把下面一句:
lua_pushlstring(L, "MsgOK!", 6); // 把返回值压进栈里
// 这个返回是指返回值的个数
return 1;
改为:
lua_pushlstring(L, "MsgOK!", 6); // 把返回值压进栈里
lua_pushlstring(L, "haha!", 5); // 把返回值压进栈里
// 这个返回是指返回值的个数
return 2;
这样我们在lua文件里就可以像下面一样取得两个返回值了:
c,d = Msg("123");
那c和d就分别是"MsgOK!"和"haha!"两个字串了。 这种自动机制用起来还是比较方便的。
3、交互栈
上面两个调用其实都是对lua栈的实用,那我们就要好好理解一个概念,lua和vc的交互栈(栈是什么?请参考数据结构的书哈。。。)lua和vc就是通过这个栈来实现交互的,这个栈的访问函数有lua_gettop,lua_settop,lua_tostring,lua_toXXX等等的函数,我们要清楚当一个函数调用发生的时候,栈里是发生了什么。上面我用了一个StackDump函数,当我们调用的时候,能很清楚的看到栈里发生了什么。
首先我们要知道从栈顶往下数就是-1、-2,从栈底往上数就是1、2。
如果使用lua_gettop(L, 1),就是取得栈底第一个元素。lua_gettop(L, -1)就是取得栈顶的第一个元素。lua_pop() (L, 1)就是把栈顶的一个元素弹出来,lua_pop()(L, 2)就是把栈顶的两个元素弹出。
好了,写了一通,最后是这个StackDump函数的实现:
int StackDump(lua_State* L) { int nTop = lua_gettop(L); //得到栈的元素个数。栈顶的位置。 OutputDebugString("The Length of stack is %d/n", nTop); //输出栈顶位置 for (int i = ; i <= nTop; ++i) { int t = lua_type(L, i); OutputDebugString("%s:", lua_typename(L, t)); //这里的typename是把类型的枚举变成字符串,是类型名。不是栈中的位置。 switch(t) { case LUA_TNUMBER: OutputDebugString("%f", lua_tonumber(L, i)); break; case LUA_TSTRING: OutputDebugString("%s", lua_tostring(L, i)); break; case LUA_TTABLE: //OutputDebugString("%s/n", lua_tostring(L,i)); break; case LUA_TFUNCTION: //OutputDebugString("%s/n", lua_tostring(L,i)); break; case LUA_TNIL: OutputDebugString("Is NULL"); break; case LUA_TBOOLEAN: OutputDebugString("%s", lua_toboolean(L, i) ? "true" : "false"); break; default: break; } OutputDebugString("/n"); } return ; }
本篇文章主要讲了lua和VC的整合、把LUA源代码和VC工程一起编译,VC调用LUA的代码,LUA调用VC的代码,返回值以及多个返回值、交互栈、输出交互栈里的元素信息等内容,下一篇将会说说如何避免阻塞的脚本,lua和多线程的使用等内容。