迷你lua 5.1参考手册

yanjing5462

UID: 35802
帖子: 6
积分: 13
在线时间: 10 分钟

1^# yanjing5462 发表于 2008-06-05 09:22

迷你lua 5.1参考手册

关键字：
　　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])对数组排序，排序函数默认是module (name [, ···])创建一个模块。require (modname)加载一个模块
模式表：
.任意字符%w字母和数字%a字母%d数字%p标点字符%s空白符%大写字母表示相应集合的补集
%u大写字母%l小写字母%x十六进制数字%z代表0的字符%c控制字符
%是转义标识 []集合 ^补集
()表示捕获 %1-9是捕获值 %bxy是以xy为标识的对称结构
?匹配前一字符0次或1次 +匹配前一字符1次或多次
*最长匹配前一字符0次或多次 -最短匹配前一字符0次或多次
以^开头的模式只匹配目标串的开始部分，相似的，以$结尾的模式只匹配目标串的结尾部分。
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")；
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=/?.lua;?.lua和LUA_CPATH=/?.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=/?.lua;?.lua和LUA_CPATH=/?.dll;?.dll，指向 luasocket-2.0.1-lua5.1-win32\lib，指向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)