Lua参考手册

来源:互联网 发布:网络批发市场 编辑:程序博客网 时间:2024/05/22 17:52

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, 2, arg {3, 4},在5.1版本多了一个...变量(实际就是参数列表),区别只在于arg和...共同存在的情况,...会使arg变nil。 可以同时返回多个结果,比如:function s() return 1,2,3,4 end     a,b,c,d s()  -- 此时,a 1, 2, 3, 
使用面向对象编程: 
    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 .. "string." -- 等于 "this 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,而是和它的两个操作数相关。     and b:如果a为false,则返回a;否则返回b     or b:如果 为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 [, [, j]]])用sep来连接数组里从i到j字符串或数字并返回一个长字符串,默认用空串从1到末尾。如果j大于i,返回空串。 table.maxn (table)返回最大正数索引或0。 
table.sort (table [, comp])对数组排序,排序函数默认是<。 
string.byte (s [, [, 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, [, 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 [, [, j]])返回s串从i到j的数值。旧版只支持2个参数 
string.match (s, pattern [, init])从init匹配或捕获值返回。旧版没有这个函数。 string.reverse (s)把s倒转。旧版没有这个函数。 module (name [, ···])创建一个模块。旧版没有这个函数。 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 do >> print(k .. "=" .. v) >> end >> end 
print_contents{x=10, y=20} 
stdin:2: attempt to call 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 
table   

结果说明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) 

0 0
原创粉丝点击