Lua必备文档：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");

Lua报错！不过直接执行生成的.exe文件却没有问题。这个问题的原因我还不清楚。