Lua必备文档:Lua学习笔记

Lua必备文档:Lua学习笔记是本文要介绍的内容,主要是在学习Lua时碰到的一些问题和得出的心得体会,适合没有任何Lua基础的朋友看。笔者会不定期的将自己的学习整理成笔记,同时由于笔者是本月刚接触Lua,也是正在学习的阶段。

我学习的最终目的是想在基于Allegro图像库的GUI构建中应用Lua,也许有的朋友的最终目的是在Web中应用Lua--或者别的目的--不过我想在通往最终应用的路途中,总会有一些共通的地方。希望我这些文字对你有所帮助。

首先提一下很容易找到的、比较正规的中文参考资料 《PIL5.0中文教程》,《Lua使用手册5.1》(风云翻译)。

本节的目的在于在VS2005中搭建一个用于测试Lua的环境。侧重点为C/C++与Lua的交互--在CPP文件中应用Lua脚本。

如何编写.lua文件:

任何文本编辑器都可以,只要写的语句符合Lua语法。保存的时候后缀名为 “.lua”。我用的Lua编辑器是LuaEdit,不过感觉除了能检测语法是不是正确之外,跟记事本没什么区别...

如何配置Lua使用环境:

如何生成编译后的LUA文件:

一定要解决上面3个问题,千万别急躁,直到你成功的配置了使用环境、能够写简单的.lua文件并生成相应的二进制中间文件之前,不要继续阅读以下文字。

好了,让我们开始RTFS(Read The Fuxking Source)。

以下是Lua脚本

--test.lua  


function f ( x, y)  


    return x + y  


end 

通过LuaEdit语法测试

//以下是test.c文件  


//  


// Lua Test Object  


// C++ Source lua_test.cpp  


//  


//  


// Include Files  


//  


extern "C"  


{  


 


    #include "D:\\My Documents\\Visual Studio 2005\\Projects\\lua\\lua\\lua.h"  


    #include "D:\\My Documents\\Visual Studio 2005\\Projects\\lua\\lua\\lualib.h"  


    #include "D:\\My Documents\\Visual Studio 2005\\Projects\\lua\\lua\\lauxlib.h"  


}  


//  


// Libraries  


//  


#pragma comment( lib ,"D:\\My Documents\\Visual Studio 2005\\Projects\\lua\\release\\lua.lib")  


//  


// Global Variables  


//  


lua_State *L;  


//  


// Lua Functions  


//  


double f( double x, double y )  


{  


 double ret;  


 lua_getglobal( L, "f");               // 获取全局变量f  


 lua_pushnumber( L,x);           // 操作数压栈  


 lua_pushnumber( L,y);           // 操作数压栈  


 lua_call( L, 2, 1);                      // 执行:2个操作数,1个返回值  


 //lua_pcall( L, 2, 1, 0);             // 保护模式的lua_call,0为错误处理码。具体应用暂时不明,在使用手册中有粗略介绍  



 ret = lua_tonumber( L, -1);    // 将栈顶元素转换成数字并赋值给ret  



 lua_pop( L, 1);                         // 从栈中弹出一个元素  


 return ret;  


}  


//  


// Main Functions  


//  


int main( void)  


{  


 int error;  



 L = lua_open();          // 创建Lua接口指针(借用DX的术语,本质是个堆栈指针)  



 luaopen_base(L);     // 加载Lua基本库  


 luaL_openlibs(L);     // 加载Lua通用扩展库  



 error = luaL_loadfile(L, "test.lua");    // 读取Lua源文件到内存  




 double ret = f( 10, 3.4);                        // 调用模版函数f  




 printf( "ret = %f", ret);                            // 输出结果,C语言的东西,跟Lua无关  



 getchar();                                               // console程序调试技巧,方便观察结果  


 lua_close( L);    // 关闭Lua接口  


 return 1;  


} 

你可以直接复制这些代码到.lua 和.cpp文件里,也可以手动敲进去,我建议后者--就跟上课记笔记一样--好记性不如烂笔头。

编译成功了吗?如果不成功一定是环境没有配置好。不过就算编译成功也是白搭:D。程序在执行到函数f()中的“ lua_call( L, 2, 1);”这句时肯定会跳出来。如果你眼睛反映够快,并且英语够好,那么在0.3秒之内你将看到来自Lua的Debug信息:PANIC: unprotected error in call to Lua API (attempt to call a nil value),这是我在程序里故意留的一个BUG。

让我们来看看为什么出错了。

在调用“ lua_call( L, 2, 1);”的时候“调用了一个空的值”,说明栈是空的。Lua在执行脚本中的函数的时候,首先会把函数体压栈,然后是操作数。

那么函数体去哪了?原因在于main()中的error = luaL_loadfile(L, "test.lua"); 这句。

首先Lua是“动态编译的脚本语言”,而loadfile只是把源文件加载到内存中,还少了“编译”这一步,可以用“luaL_dofile(L,"test.lua");”来替换,它既加载又编译。替换之后执行应该就没有问题了。

但是还没完,luaL_dofile 实际上是个宏:

#define luaL_dofile(L, fn) \  


 (luaL_loadfile(L, fn) || lua_pcall(L, 0, LUA_MULTRET, 0)) 

LUA_MULTRET也是宏定义,值为-1,表示函数有多个返回值(Lua规则,pil 24.2--堆栈)。

扩展开来就是以下两句:

luaL_loadfile(L, fn);  


lua_pcall(L, 0, LUA_MULTRET, 0); 

pcall以上述参数执行的时候,会把加载到内存中的源程序编译成可以用于执行的2进制代码,并将全局变量压栈(在Lua中,函数也是变量,pil 2.5 -- Functions,毕竟函数名和函数体是不同的2个东西)。就跟PE文件格式里的Section一样(PE文件就是Windows3.1之后的.exe/.dll文件)。当然如果你不知道什么PE文件也没关系--我只是打个比方--就当成VS2005编译代码时生成的.obj文件。

虽然实际使用中99%的情况都是直接使用dofile,但是我想将该问题提出来说可以更加直观的理解“动态编译”。

另外一个需要特别注意的是,在test.lua中,定义了一个模板函数 f,接受2个操作数( x , y ),所以需要在CPP文件中定义该函数的CPP模板 double f ( double x, double y),它们一定是成对出现的(不然我们为什么要用Lua呢:D)。当然,你也可以让CPP的函数 f 接受3个参数 x, y, z,但是只把y , z 压栈,x单独做处理,同样的道理也可以应用于LUA文件。源代码我就不写了,你可以当作练习。

最后,我想谈谈luac.exe 和.OUT文件--也就是独立的LUA编译器生成的2进制文件。因为.LUA太直接,源代码可以直接看到,同时动态编译也是要花费额外的时间(可能还有别的理由,通过进一步的学习应该可以发现),所以使用.out文件是比较好的方案。

那么现在直接loadfile总可以了吧?很可惜不行!loadfile这个函数实在太傻了,只管读入文件,而负责判断读入的是源文件还是经过编译的二进制代码的工作是由lua_pcall()来做的--如果是源文件,就编译后压栈,如果是二进制代码,就直接压栈。

再一个就是,如果你在程序中使用OUT文件,在VS2005中调试的时候,依然会报attempt to call a nil value的错误--就算你用的是luaL_dofile()!

比如:error = luaL_dofile(L, "luac.out"); 

相关推荐