LUA脚本文档中文翻译(基础)
介绍
Lua读作“鹿啊”,是一种据创作者说的类Pascal脚本语言。巴西人做的,其名字"lua"是西班牙语的月亮。Lua是目前在游戏工业中用得最多的脚本语言。优点是执行速度快。
基本概念
一段脚本就是一组命令和数据。
命令的术语叫作语句,一段语句可以用do ... end括起来构成一个语句块。语句块是一个相对独立的块,逻辑上等同于一条语句。
脚本中两个减号“--”后面到行末的内容为注释,脚本解释器会忽略它们。
多行注释为“-- [[”打头直到匹配的“]]”。
标识符是字母或下划线打头由字母、下划线和数字组成的标识,用作变量名或函数名。
下文中标**的内容不必要掌握。
数据
数据分不同的类型。Lua支持的类型有:
nil:空类型,即没有数据
boolean:布尔类型,即真(true)或假(false)
number:数值类型,如123,24.5,1.23e-12 (即1.23乘10的-12次方)
string:字符串,即一段文字
table:数据表类型,即键-值数据对的集合
function:函数,即一段命令,在脚本中命令也可作为数据操作
userdata:用户数据,扩展的数据类型 **
thread:线程类型 **
保存数据的东西叫变量。变量分全局变量和局部变量。全局变量一直存在,局部变量只执行到它所在的局部才存在。应该尽量使用局部变量,以避免逻辑错误。
例:
local x = 10 -- 局部变量x保存数值10
local title = "你好" -- 局部变量title保存字符串"你好"
local dead = true -- 局部变量dead保存真
x = 10 -- 全局变量x保存10
do -- 语句块
local x = x -- 局部变量x被赋予全局变量x的值,只在块内存在
print(x) --> 显示10
x = x+1
do -- 又一个内部语句块
local x = x+1 -- 又一个局部变量只在该块内存在
print(x) --> 显示12
end
print(x) --> 显示11
end
print(x) --> 显示10 全局变量x的值
字符串
字符串数据使用引号括起来以区别于其他符号,注意是英文引号。如:
"Hello, world!"
字符串中,用“/"”表示引号,用“/'”表示单引号,用“//”表示“/”,用“/n”表示换行。
表达式
表达式就是算式概念的扩展。
数学表达式的运算符有 +, -, * (乘), / (除), ^ (指数),- (负号)
如果操作数是字符串类型,并可以被转换成数值,则将自动转换成数值
关系运算符返回布尔值true或false,有:== (等于),~= (不等于),< (小于),> (大于),<= (小于等于),>= (大于等于)
注意,对数值类型不要用==比较,应判断两数的差是否小于一个足够小的数,否则对有些数看起来相等却不相等。0 除外。
逻辑运算符包括:and (和,并且), or (或者),not (非,不)
逻辑运算的操作数一定要是布尔类型或nil,nil表示空,被当作false处理。使用其他类型的操作数不会报错,因为有其特定的功能,但坚决不推荐使用。
字符串连接运算符:.. (取得两个字符串连接后的字符串)
如果操作数是数值型,则自动转换为字符串
优先级,从底到高:
or
and
< > <= >= ~= ==
..
+ -
* /
not - (负号)
^
..和^是右结合,就是说 2^2^3 == 2^(2^3)。
例:
hp < 10 and not player.frozen -- hp小于10 并且 玩家没有被冰冻 时为真
流程控制语句
while 表达式 do
语句块
end
如果表达式的结果为true,则执行语句块,到end后返回while再循环。如果表达式的结果为false,则跳过语句块执行end后的语句。
repeat
语句块
until 表达式
先执行语句块,再判断表达式是否为true,是则继续向下执行,否则返回repeat重复。
循环内可用break语句跳出包含该break的一层循环。
if 表达式 then
语句块
else
语句块
end
if 表达式 then
语句块
elseif 表达式 then
语句块
else
语句块
end
根据表达式的结构选择执行。
for 循环变量 = 初值, 终值 do
语句块
end
for 循环变量 = 初值, 终值,每次的增量 do
语句块
end
绝对不要在for语句块中修改循环变量。
函数
函数即可被重复调用的语句块。
function 函数名(参数列表)
语句块
end
参数列表为用逗号分隔的变量名列表,当执行到函数体内部时,他们就是函数体内的局部变量,并且已用调用时指定的实参赋值。参数列表可以为空。
函数可以返回值给调用者,使用
return 返回值
执行return之后将从函数返回调用者的下一条语句继续执行。
例:
function max(a, b)
if a > b then
return a
else
return b
end
local c = max(10, 20) -- c == 20
调用函数时使用
函数名(参数列表) 或 函数名()
注意括号必须加上,这样才表示函数调用,执行函数内的语句。
如果不加则表示一个函数类型的值。*
当需要返回多个值时,使用
return 返回值1,返回值2,...
调用时用多个变量接收返回值,例:
local v1, v2, v3
v1, v2, v3 = a_multi_return_value_funtion()
注意尽量不要使用多返回值,因为脚本解释器不检查变量的个数是否匹配,多则丢弃,少则置nil,容易倒致错误而不易发现。
数据表
数据表是脚本系统的核心数据结构,本质上是从键到值的映射。其它的数据结构都由数据表表示。
如数组,以从1开始的整数为键索引:
local arr = {10, 100, 1000} -- arr[1] = 10, arr[2] = 100, arr[3] = 1000
词典,以字符串索引:
local dict = {"pig" = "猪", "dog" = "狗"} -- dict["pig"] = "猪" ……
对象,以属性(即对对象的描述)名索引:
local pig = {legs = 4, tail = 1, name = "猪"} -- pig.legs = 4 ……
作为对象使用时,字符串作键、函数作值即表示对象的方法(即对对象的操作),调用方法的例子:
deamon.attack(deamon, target, strength)
也可简写为
deamon:attack(target, strength)
即是说因为第一个参数也是数据表,所以将点换成冒号并省掉第一个参数。
使用数据表的for语句
for 循环变量i, 循环变量v in ipairs(数据表t) do
语句块
end
i是整数键,v是值
循环将逐次得到 (i = 1, v = t[1]), (i = 2, v = t[2]), ……
for 循环变量k, 循环变量v in pairs(数据表t) do
语句块
end
k是键,v是值
循环将逐次得到数据表中的每一个键-值对。
绝对不要在for语句块中修改循环变量。
常用函数
assert(v [, message]) -- 用于调试,断言v一定为true,否则说明有逻辑错误,中断运行并显示message的内容。
tostring(e) -- 将e转换成字符串
tonumber(e [, base])-- 将e转换成数值,如果指定base,则按指定的进制转换
next(table [, index]) -- 取数据表中index的下一个索引键;如果省略index则返回第一个;如果index为最后一个则返回nil。
error(message [, level]) -- 终止执行并给出错误信息
数据表函数
table.sort(table [, comp]) -- 将数据表元素按值排序。如果指定comp比较函数,则使用comp函数进行比较。comp应有两个参数,当a<b时返回true。
table.insert(table, [pos,] value) -- 在table的pos索引位置插入value。
table.remove(table [, pos]) -- 删除table中索引为pos的元素,省略pos时为最后一个元素。
table.foreachi(table, f) -- 对table中每一个值,调用f函数,参数为整数索引和元素值
table.foreach(table, f) -- 对table中每一个值,调用f函数,参数为键和值
数学库函数
math.abs math.acos math.asin math.atan math.atan2
math.ceil math.cos math.deg math.exp math.floor
math.log math.log10 math.max math.min math.mod
math.pow math.rad math.sin math.sqrt math.tan
math.frexp math.ldexp math.random math.randomseed