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下