Lua参考手册

Lua 参考手册

关键字：

and break do else elseif end false for function if in local nil not or repeat return then true until while

使用变量不需要声明，总是全局变量，除非加"local"。local的作用域是在最里层的end和其配对的关键字之间。全局变量的作用域是整个程序。

大小写相关。定义一个变量的方法就是赋值"＝"操作。变量类型，可以用type()函数来检查：

Nil 空值，所有没有使用过的变量都是nil。nil既是值又是类型。变量清除直接给变量赋以nil值。 Boolean 布尔值true 和 false。只有false和nil才被计算为false，而所有任何其它类型的值，都是true。比如0，空串等等，都是true。

Number 数值，相当于C语言的double实数如：4 0.4 4.57e-3 0.3e12 5e+20

Userdata 可以是宿主的任意数据类型，常用的有Struct和指针。

Thread 线程类型，在Lua中没有真正的线程，将一个函数分成几部份运行。

String 字符串，可以包含'\0'字符，可以定义很长的字符串。用双引号或单引号引用单行，"[["和"]]"引用多行字符串。新版支持"[==["和"]==]"多层标记，=号个数为层数。严格按层数匹配。支持一些转义字符： \a铃\b退格\f换页\n换行\r回车\t制表符\v垂直制表\\反斜杠"双引号\'单引号\[左中括号\]右中括号

Table 关系表类型，功能强大。可以用除了nil任意类型的值来作数组的索引和内容。 Table的定义：T1 = {} T1[1]=10 T1["John"]={Age=27, Gender="Male"} 这一句相当于T1["John"]["Gender"]="Male" 索引是字符串时可以简写成：T1.John.Gender="Male"或T1.John={Age=27,
Gender="Male"}

第一，所有元素之间，总是用逗号"，"隔开；

第二，所有索引值都需要用"["和"]"括起来；如果是字符串，还可以去掉引号和中括号；

第三，如果不写索引，则索引就会被认为是数字，并按顺序自动从1往后编；

T1={10, -- 相当于 [1] = 10 [100] = 40, John= -- 如果你原意，你还可以写成：["John"] = { Age=27, --
如果你原意，你还可以写成：["Age"] =27 Gender=Male -- 如果你原意，你还可以写成：["Gender"] ="Male" }, 20 -- 相当于 [2] = 20}

Function 函数也是一种类型，也就是说所有的函数本身就是一个变量。 函数的定义：function add(a,b) return a+b end 相当于add = function (a,b) return a+b end 如果函数只有一个参数，可以省略括号。 return语言一定要写在end之前。在中间放上return，写成：do return end。函数可以接受可变参数个数，用"..."来定义function
sum (a,b,...)

如果想取得...所代表的参数，5.0版本可以在函数中访问arg局部变量（表类型）得到。如 sum(1,2,3,4)则，a = 1, b = 2, arg = {3, 4}，在5.1版本多了一个...变量（实际就是参数列表），区别只在于arg和...共同存在的情况，...会使arg变nil。 可以同时返回多个结果，比如：function s() return 1,2,3,4 end a,b,c,d = s() -- 此时，a = 1, b = 2, c = 3, d = 4

使用面向对象编程：

t = { Age = 27, add = function(self, n) self.Age = self.Age+n end } print(t.Age) -- 27

t.add(t, 10) 可以简写成：t:add(10) print(t.Age) -- 37

单行注释"--"。只要--后面第一个字符不是多行字符串引用符[[，即为多行注释。 语句之间可以用分号"；"隔开，也可以用空白隔开。

条件控制：

if 条件 then … elseif 条件 then … else … end

While循环：while 条件 do … end

Repeat循环：repeat … until 条件

For循环：for 变量 = 初值，终点值，步进 do … end 可以省略步进值，这时候，for循环会使用1作为步进值。

For循环：for 变量1，变量2，… ，变量N in表或枚举函数 do … end

语句块用do 和 end 括起来的。可以在函数中和语句块中定局部变量。

赋值语句可以同时给多个变量赋值。

例如：a,b,c,d=1,2,3,4甚至是：a,b=b,a 方便的交换变量功能

默认变量总是全局的。定义局部变量，则在第一次赋值的时候用local说明。比如： local a,b,c = 1,2,3 -- a,b,c都是局部变量

数值运算支持 +, -, *, /,^,#,%。^表示指数乘方。比如2^3 结果为8。5.1版加了#长度运算符。字符串的长度单位为字节，表的长度为nil前的整数索引个数，也就是数组的个数，如果有名为n的索引，它的值就是长度。5.1版引进%模运算。

用".."连接两个字符串。如："This a " .. "string." -- 等于 "this a string"

比较运算< > <= >= == ~=分别表示小于，大于，不大于，不小于，相等，不相等。总是返回true或false。对于Table，Function和Userdata类型的数据，只有 == 和 ~=可以用。相等表示两个变量引用的是同一个数据。比如： a={1,2} b=a print(a==b, a~=b) -- true, false

a={1,2} b={1,2} print(a==b, a~=b) -- false, true

逻辑运算and, or, not只有false和nil才计算为false，其它任何数据都计算为true，0也是true！ and 和 or的运算结果不是true和false，而是和它的两个操作数相关。 a and b：如果a为false，则返回a；否则返回b a or b：如果 a 为true，则返回a；否则返回b 运算符优先级，从高到低顺序如下： ^

not - （一元运算）# * / %

+ -

..（字符串连接） < > <= >= ~= ==

and

or =

常用标准库函数:

print (···)把所有参数打印出来，利用tostring (e)转换非字符。奇怪的是nil不能做..操作。 table.insert (table, [pos,] value)在pos位置插入一个值，默认是末尾。 table.remove (table [, pos])在pos位置删除一个值，默认是末尾。

table.concat (table [, sep [, i [, j]]])用sep来连接数组里从i到j字符串或数字并返回一个长字符串，默认用空串从1到末尾。如果j大于i，返回空串。 table.maxn (table)返回最大正数索引或0。

table.sort (table [, comp])对数组排序，排序函数默认是<。

string.byte (s [, i [, j]])返回s串从i到j的数值。旧版只支持2个参数

string.char (···)和byte函数功能相反，返回0或多个数字对应的字符串。

string.find (s, pattern [, init [, plain]])从s串中从init位置开始找到第一个匹配模式的子串位置，并返回起点和终点。plain如果为true，忽略模式。如果使用了捕获，则增加返回捕获的部分。

string.gmatch (s, pattern)这是一个迭代函数，每次返回一个匹配的串。旧版叫gfind。如果使用了捕获，则返回捕获的部分。

string.gsub (s, pattern, repl [, n])用rep1替换。n限制替换个数。%1-9表示被捕获的值。如果第3个参数是个函数并返回假，替换字符将保持原配而不是旧版的空串。

string.sub (s, i [, j])返回s从位置i到j的子串。负值表示从末尾往前数的位置。默认从1到末尾。

string.match (s, pattern [, init])从init匹配或捕获值返回。旧版没有这个函数。 string.format (formatstring, ···)格式化输出。%q可以输出安全字符串。 string.rep (s, n)把s复制n份

string.reverse (s)把s倒转。旧版没有这个函数。 string.len (s)计算字符串长度。

string.lower (s)小写化。string.upper (s)大写化。 io.read (···)"*n"读一个数字，支持各种格式；"*a"读整个文件；"*l":读一行，默认；"n"读n个字符

io.write (···)写字符或者数字

io.lines ([filename])迭代返回文件中的一行。 pairs (t)迭代返回表中的键值对

ipairs (t)迭代返回数组中的索引和值

c调用lua函数一般的过程是:

1. load一个lua的文件，形成一个闭包并执行它 2. 在栈中压入函数的名称

3. 依次在栈中压入函数的实参

4. 使用lua_pcall调用lua函数。 形式是: lua_pcall(L, 参数个数,结果个数, 错误处理函数在栈中的索引)

此时此函数相关的栈已经被清空。执行lua完毕后，如果成功，结果依次将压入栈中， 如果不成功，错误信息将 压入栈中 5. 从栈中读取返回结果或者错误信息。 lua调用c函数(写成库的例子)

lua调用库在windows下是dll文件，在unix/linux下面是so文件 vs的过程如下：

1. 新建一个dll的工程

2. 定义一个def文件，定义dll的导出，mylib.def定义如下: LIBRARY mylib.dll

DESCRIPTION "first dll for lua" EXPORTS

luaopen_mylib

3. 编写库，新建一个cpp文件.

4. 定义库函数，这里以pil的lsin函数，输出传入参数的sin()值

5. 定义luaL_reg数组，这个是注册一系列公开给lua调用的函数数组. 数组最后一个元素必须是 {NULL, NULL} 的luaL_reg结构用来做结束标识. 6. 用luaL_openlib声明主函数 5.1版本和5.0版本的区别：

新模块系统，增量垃圾收集，varargs新机制，多行字符串或引用的新语法，#和%新操作符， metatable支持所有类型，使用luaconf.h来配置lua暂时避免版本冲突，完善的reentrant parser。Pil第二版包括了5.1的新内容，增加了新例子，对新模块系统，多状态和垃圾收集的详细阐述。 语法：

函数传递可变参数用...来代替局部arg表。不使用...时，arg用法和旧版本一样；但使用...后（无论先后），局部arg都会变成nil。

在repeat.until里，局部变量的生命周期覆盖到until条件后面； 多行字符串或引用的新语法使用多层匹配代替以前的嵌套； #和%新操作符。

库函数：

string.gfind改为string.gmatch；

如果调用string.gsub的第3个参数是个函数，如果函数返回假，替换字符将保持原配而不是旧版的空串；

table.setn废弃，table.getn改为使用#； loadlib改为package.loadlib； math.mod改为math.fmod；

table.foreach和table.foreachi作废。可用for循环pairs或ipairs代替； require从package.path而不是LUA_PATH得到path值； collectgarbage (opt [, arg])参数从[limit]改为更多选择，gcinfo废弃改为collectgarbage("count")；module (name [, ···])创建一个模块。require (modname)加载一个模块 模式表：

.任意字符%w字母和数字%a字母%d数字%p标点字符%s空白符%大写字母表示相应集合的补集

%u大写字母%l小写字母%x十六进制数字%z代表0的字符%c控制字符 %是转义标识 []集合 ^补集

()表示捕获 %1-9是捕获值 %bxy是以xy为标识的对称结构

?匹配前一字符0次或1次 +匹配前一字符1次或多次

*最长匹配前一字符0次或多次 -最短匹配前一字符0次或多次 以^开头的模式只匹配目标串的开始部分，相似的，以$结尾的模式只匹配目标串的结尾部分。

string.byte (s [, i [, j]])返回s串从i到j的数值。旧版只支持2个参数

string.match (s, pattern [, init])从init匹配或捕获值返回。旧版没有这个函数。 string.reverse (s)把s倒转。旧版没有这个函数。 module (name [, ···])创建一个模块。旧版没有这个函数。 C API：

5.1版本增加了以luaL_开头的辅助库Auxiliary Library； luaL_getn改为lua_objlen，luaL_setn废弃； luaL_openlib改为luaL_register；

luaL_checkudata改为抛出异常而不是返回NULL。

luaopen_* functions不能直接调用，改为像调用其它普通c函数一样的过程；

lua_open改为lua_newstate，可以设置内存分配方法。luaL_newstate默认使用realloc分配方法；

5.0的调用方法：

lua_State *L = lua_open(); luaopen_base(L); luaopen_string(L);

luaopen_math(L); 5.1的调用方法：

lua_State *L = luaL_newstate(); lua_cpcall(L, luaopen_base, 0); lua_cpcall(L, luaopen_io, 0);

lua_cpcall(L, luaopen_math, 0); lua_cpcall(L, luaopen_string, 0);

lua_pushcfunction(L, luaopen_*);lua_call();等价于lua_cpcall(L, luaopen_*, 0); 参考资料：

参考手册：http://www.lua.org/manual/5.x/

lua 5.1 win32解析器：http://luaforge.net/frs/download.php/2218/lua5_1_2_Win32_bin.zip lua 5.1 VC++6.0 库：http://luaforge.net/frs/download.php/2241/lua5_1_2_Win32_vc6_lib.zip luasocket 参考手册：http://www.cs.princeton.edu/~diego/professional/luasocket/reference.html luasocket win32扩展包luasocket-2.0.1-lua5.1-win32下

载

：

http://luaforge.net/frs/download.php/1618/luasocket-2.0.1-lua5.1-win32.zip

tolua++ 参考手册：http://www.codenix.com/~tolua/tolua++.html

tolua++ 1.0.92 源代码下载：http://www.codenix.com/~tolua/tolua++-1.0.92.tar.bz2

其他经验：

lua的扩展库luasocket, luasql, luacom, kepler...

程序可以存成cpp也可以存成c, 如果以.c为扩展名就不需要加extern "C" c和lua交互的时候，栈的编号是从1-n，也可以取负值，-1表示末尾

设置环境变量LUA_PATH="E:\LuaEdit\myproject\?.lua"，然后使用require "lua包/文件名"。然后就可以直接使用lua文件里的函数而不需要dofile(路径)了。在windows下的路径如果是\必须写成\\，或者/。

lua5.1win32的解析器下载来后可以直接使用。luasocketwin32扩展包下载后，需要正确设置LUA_PATH=< LDIR>/?.lua;?.lua和LUA_CPATH=<CDIR>/?.dll;?.dll。然后运行lua解析器， require

相应的socket包就可以了。

在VC++6下编译带lua的.dll文件的时候，在工程设置里必须指明LIBC.lib Libcmtd.lib的加载顺序。选择VC菜单Project->Settings->Link->Catagory然后在 Object/library Modules的Edit栏中填入LIBC.lib Libcmtd.lib。否则会出现： Linking...

LIBC.lib(crt0dat.obj) : error LNK2005: __cinit already defined in LIBCMTD.lib(crt0dat.obj)

新版本下表迭带需要加pairs(t)，旧版本以下代码结果是正确的： Lua 5.1.2 Copyright (C) 1994-2007 Lua.org, PUC-Rio > function print_contents(t) >> for k,v in t do >> print(k .. "=" .. v) >> end >> end

> print_contents{x=10, y=20}

stdin:2: attempt to call a table value stack traceback:

stdin:2: in function 'print_contents' stdin:1: in main chunk [C]: ?

新版本中的...和arg不能同时出现，无论先后，...的出现都会使arg为nil： print(#arg)

function test(...) --print(...)

print(type(arg),#arg) --print(...) end

test(1,2,3,4) print(#arg)

运行结果：

E:\lua5_1_2_Win32_bin>lua5.1 e....lua 1 2 3 3

table 4

3

结果说明arg在新版本中还是可以使用的，但跟...冲突，跟全局表arg不冲突。但本地arg会覆盖全局的arg，如果两者都要调用该如何处理？使用...后，编译器仍然把函数里的arg看成是局部变量。因此变通的方法是： print(#arg) t=arg

function test(...) print(...) arg=t

print(type(arg),#arg)

--print(...)

end

test(1,2,3,4) print(#arg)

这和旧版本是一样的。看来引入...的用意不是为了区分全局和局部的arg。那究竟是为了什么呢？？

lua安装： Windows:

把etc目录下的luavs.bat 拷到lua的解压根目录下直接运行, 生成的.h .dll .lib .exe文件都在src下。 Linux:

$make linux && make install 标准的linux安装

在Windows XP SP2下使用Visual C++ 6. 编译lua的过程分为3步： 1，建立静态库工程，编译库文件

Lua库由标准库和核心库组成，我用的是5.1版本，所有代码都放在src目录中。把src目录中除lua.c,luac.c文件外所有的*.c文件添加到项目中，设置一下输出路径，F7编译就可以了。

2,建立Win32控制台工程 编译lua.exe Lua解释器

把lua.c添加到工程中，link选项中包含进刚才编译好的lib文件，F7编译

3.再建立Win32控制台工程， 编译luac.exe Lua编译器

同上步一样，编译成功后生成luac.exe， 最好把这两个文件放在新建的bin文件下，在添加进系统的环境变量。

tolua++在cygwin下不用SCons编译：

详见http://lua-users.org/wiki/CompilingToluappWithoutScons

src/lib下：

gcc -shared -o tolua++.dll *.c /usr/local/lib/lua51.dll -I../../include -I/usr/local/include gcc -c *.c -I../../include -I/usr/local/include ar rcsv libtolua++.a *.o src/bin下：

gcc tolua.c toluabind.c -I../../include -I/usr/local/include -L /usr/local/lib -llua -L../lib/ -ltolua++ 然后把所得到的文件复制到系统相应目录中。

使用tolua用.pkg生成.cpp的时候，在生成的.cpp最前面设置#define TOLUA_API extern "C" __declspec(dllexport)可以使.dll文件导出时不改变文件名。貌似还要加 #ifndef __cplusplus#define __cplusplus#endif

使用cygwin产生的.dll文件不能被lua使用。用同一源文件在vc下生成的.dll文件是可以被lua用的。

使用VC编译tolua时，把除了tolua.c和xxx.defalt以外的.c和.h都包含进去，然后在tolua++.h里设置 #define TOLUA_API extern "C" __declspec，不断得修改#include "tolua++.h"在各个文件中的位置，使得用dumpbin看到65个导出函数为止。貌似VC6版本太低不能成功设置预编译处理选项，因此这样麻烦点。编译成功后就有.lib和.dll文件供接下来的.dll工程使用。

extern "C" _declspec(dillexport) extern "C" void DLL_EXPORT __stdcall

============

实际应用场景练习

============

一、利用Lua的Table实现类的多继承： 1、假设基类为B1、B2 2、继承的类为A 3、使用的时候类似于： Instance1 = A:new()

Instance1:Method1(arg1, arg2)

这个不难，但是务必要掌握table的应用

答案：见OO.lua。在lua解析器下运行：dofile "OO.lua"

二、利用lua的扩展包luasocket实现http的一个应用：

1、构造http协议，访问www.qq.com，具体的访问方式网上有例子。 2、在返回来的http包中，取出腾讯公司的客服电话号码 -- 需要使用到lua的字符串查找和模式匹配函数。

答案：

下载lua5.1win32的解析器和luasocketwin32扩展包，正确设置LUA_PATH=< LDIR>/?.lua;?.lua和LUA_CPATH=<CDIR>/?.dll;?.dll，<CDIR>指向 luasocket-2.0.1-lua5.1-win32\lib，<LDIR>指向luasocket-2.0.1-lua5.1- win32\lua。lua程序见Phone.lua。在lua解析器下运行：dofile "Phone.lua" ----------------------------

http = require("socket.http")

qqweb = http.request("http://www.qq.com")

tel=string.match(qqweb,"腾讯客服电话：(%d+%-%d+)") print("您要的电话号码是："..tel) -------------------------------

三、在Windows下，利用C++实现一个基本的Socket类库来给Lua使用： 1、结合tolua++进行编译，生成Lua可以调用的dll文件，请参考网上的资料来熟悉tolua++的使用

2、假设dll文件名为MySocket.dll，类为CMySocket，则调用的时候类似于： require("MySocket")

Instance1 = CMySocket:new() Instance2 = CMySocket:new() Instance1:Listen(9701)

Instance2:Connect("127.0.0.1",9701) 答案：

windows下编译lua：

把etc目录下的luavs.bat 拷到lua的解压根目录下直接运行, 生成的.h .dll .lib .exe文件都在src下。

把相应的.h文件和lua51.lib文件拷贝到VC相应目录下。lua.exe和lua51.dll为lua解析器。

在cygwin下编译安装方法：$make linux && make install

用cygwin编译安装tolua++，且不用SCons编译： src/lib下：

动态链接文件：

gcc -shared -o tolua++.dll *.c /usr/local/lib/lua51.dll -I../../include -I/usr/local/include 静态连接文件：

gcc -c *.c -I../../include -I/usr/local/include ar rcsv libtolua++.a *.o src/bin下：

执行文件，改名为tolua++.exe：

gcc tolua.c toluabind.c -I../../include -I/usr/local/include -L /usr/local/lib -llua -L../lib/ -ltolua++ 然后把所得到的文件复制到系统相应目录中。

根据mysocket.h设计mysocket类模式，写成.pkg文件。 产生binding文件mypkg.cpp备用，此时要用到mysocket.h：tolua++ -o mypkg.cpp mysocket.pkg 适当修改一下生成的mypkg.cpp文件，使以后导出的.dll文件函数名不变。 #define TOLUA_API extern "C" __declspec

用以下方法在cygwin下编译的.dll文件不能被lua使用，加载包会失败。

g++ -shared -o MySocket.dll *.cpp /usr/local/lib/lua51.dll -I/usr/local/include -I.. -L /usr/local/lib -ltolua++

改用VC来编译。先编译tolua++。

把src下除了tolua.c和toluabind_default.x以外的.c和.h都包含进去。工程设置里要包含LIBC.lib Libcmtd.lib tolua.lib lua5.1.lib，include和lib路径也要包含lua的。然后设置#define TOLUA_API extern "C" __declspec编译成功后就有tolua.lib和tolua.dll文件供接下来的.dll工程使用。

把bingding文件mypkg.cpp和写好的mysocket.cpp，mysocket.h一起在VC下编译生成.dll文件。工程设置里要包含LIBC.lib Libcmtd.lib tolua.lib lua51.lib，include和lib路径也要包含lua或tolua的。前面两个文件顺序一定不要写错，否则产生如下错误：

Linking...

LIBC.lib(crt0dat.obj) : error LNK2005: __cinit already defined in LIBCMTD.lib(crt0dat.obj) 编译产生的MySocket.dll文件就可以被lua调用了。 运行一个lua解析器程序实例，执行： require("MySocket") Instance1 = CMySocket:new() Instance1:Listen(9701)

再运行另一个lua解析器程序实例，执行： require("MySocket") Instance2 = CMySocket:new() Instance2:Connect("127.0.0.1",9701)