Lua 函数库 总汇

Lua 5.3 参考手册 (中文版)http://cloudwu.github.io/lua53doc/contents.html

字符串库 (均以"string."开头)
byte(s[,i[,j]]) 返回字符串的内部数字编码,i、j为字符串的索引,i和j限定了多少字符就返回多少值
char(…) 吧数字编码转换为字符串
dump(function[,strip]) 序列化函数,返回一个字符串,使用load可以反序列化该函数
find(s,pattern[,init[,plain]]) 用来查找匹配的pattern,返回该pattern的索引,找到一个匹配就返回,如果找不到,返回nil
format(formatstring[,value[,…]]) 格式化字符串
match(s,pattern[,init]) 与find相同,不同在于这个返回第一个匹配的内容
gmatch(s,pattern) 返回一个迭代器函数,每次调用这个迭代器函数都会返回一个匹配该字符串的值
gsub(s,pattern,repl[,n]) 将每个匹配pattern的字符串替换为repl,返回替换完毕的字符串和替换次数,如果repl为函数,则用匹配到的参数作为参数调用这个函数,如果是表,则用匹配到的参数作为键去查找这个表
len(s) 返回字符串的长度
lower(s) 将字符串转换为小写
upper(s) 将字符串转换为大写
rep(s,n[,sep]) 将某个字符串自我复制链接起来,n是次数,sep为连接符
reverse(s) 反正字符串
sub(s,i[,j]) 截取字符串,i为起始,j为结束
数学库(均以“math.”开头)
abs (x) 取绝对值
acos(x) 反余弦函数
asin(x) 反正弦函数
atan2(x,y) x/y的反正切值
atan(x) 反正切函数
ceil(x) 不小于x的最大整数 如:x =5.8 返回 6 x=-3.5 返回3
cosh(x) 双曲线余弦函数
cos(x) 余弦函数
deg(x) 弧度转角度
exp(x) 计算以e为底x次方值
floor(x) 不大于x的最大整数
fmod(x,y) 取模运算
frexp(x) 把双精度数val分解为数字部分(尾数)和以2为底的指数n
ldexp(x,y) 计算value*2的n次方
log10(x) 计算以10为基数的对数
log(x) 计算一个数字的自然对数
max(…) 取参数中的最大值
min(…) 去参数中的最小值
modf(x) 把数分为整数和小数
pow(x,y) 得到x的y次方
rad(x) 角度转弧度
random(x[,y]) 获取随机数
randomseed(x) 设置随机数的种子
sinh(x) 双曲线正弦函数
sinh(x) 正弦函数
sqrt(x) 开平方函数
tanh(x) 双曲线正切函数
tan(x) 正切函数
Table 函数库(均以"table."开头)
concat(table[,sep[,i[,j]]]) 将table使用sep作为连接进行连接,i和j是限定坐标
insert(table,[pos,]value) 在的table的pos处插入value,不指定pos会在添加在表的末尾
move(table1,f,e,t[,table2]) 将元素从table1移动到table2
pack(…) 获取一个索引从1开始的参数表table,并会对这个table预定义一个字段n,表示该表的长度
remove(table[,pos]) 移除table中pos上的元素,并返回这个被移除的值
sort(table[,comp]) 对数组进行排序,没有提供排序函数,默认为<操作
unpack(table[,i[,j]]) 返回table里的元素
getn(table) 获取table中的元素个数
maxn(table) 返回指定table中所有正数key值中最大的key值,如果不存在key值为正数的元素则返回0
Lua库函数
assert(v[,message]) 相当于C的断言功能,当v为nil或者false将处罚错误,message为发生错误时返回的信息
collectgarbage(opt[,arg]) 用于操作垃圾收集器。opt:操作方法标志(“collect”:做一次完整的垃圾收集循环;“count”:返回当前Lua中使用的内存量(KB);“stop”:停止垃圾收集器;“restart”:重启垃圾收集器;“step”:单步执行一个垃圾收集器,步长“size”由参数arg指定;“setpause”:设置arg/100的值作为暂定收集时长;“setstepmul”:设置arg/100的值,作为步长的增幅)
dofile(filename) 打开并且执行一个lua块
error(message[,level]) 终止正在执行的函数,并返回message的内容作为错误信息(error函数永远都不会返回),level参数:level=1(默认):为调用error文职(文件+行号) level=2:指出那个调用error函数的函数 level=0:不添加错误位置信息
_G 全局环境的变量值表
getfenv(f) 返回函数f的当前环境表
getmetatable(object) 返回指定对象的元表(如果object的元表__metatable有值,返回__metatable,否则返回nil)
load(func[,chunkname]) 用于加载一个数据块。从字符串或者函数中加载一个代码为方法并返回
loadfile([filename]) 与load类似,但加载的是一个文件,如果没有指定文件名加载标准输入(stdin)的内容
loadstring(string[,chunkname]) 与load类型,但加载的一个字符串
next(table[,index]) 允许程序遍历表中的每一个字段,返回下一索引和该索引的值;table:要遍历的表,index:要返回的索引的前一索引号,当index为nil[]时,返回第一个索引的值,当索引号为最后一个索引或表为null是将返回nil,可以用来判定table是否为nil
ipairs(t) 泛型for迭代器,类似于foreach
pcall(f,arg1,…) 在保护模式调用函数(即发生的错误将不会反射给调用者),当调用函数成功能返回true,失败时将返回false加错误信息
print(…) 以tostring方式格式化输出参数的内容
rawequal(v1,v2) 检测v1是否等于v2,此函数不会调用任何元表的方法
rawget(table,index) 获取表中指定索引的值,此函数不会调用任何元表的发放,成功返回相应的值,当索引不存在时返回nil 注:只能用于以数字索引访问的表
rawset(table,index,value) 设置表中指定索引的值,此函数不会调用任何元表的方法
select(index,…) 当index为数字将返回所有index大于index的参数,当index为“#”,返回参数的总个数
setfenv(f,table) 设置函数f的环境表为table,f可以为函数或调用栈的级别,级别1 为当前的函数,0将设置当前线程的环境表
setmetatable(table,metatable) 设置指定table的元表metatable,如果当table有__metatable字段时,会触发错误
tonumber(e[,base]) 将e转换为数字,不能转换返回nil,base(0~36)指出参数e当前使用的进制
tostring(e) 将参数e转换为字符串,会触发元表__tostring事件
type(v) 返回参数的类型
unpack(list[,i[,j]]) 返回指定表的索引的值,i为起始索引,j为结束索引
_VERSION 返回当前lua的版本号
xpcall(f,err) 与pcall类似,在保护模式下调用函数,可以指定一个新的错误处理函数句柄
元表方法
__add 运算符+
__sub 运算符-
__mul 运算符*
__div 运算符/
__mod 运算符%
__unm 运算符-(取反)
__concat 运算符…
__eq 运算符==
__lt 运算符<
__le 运算符<=
__call 可以让table当做一个函数来使用
__tostring 转换为字符串
__index 调用一个索引,可以是表和方法,当调用table的一个不存在引用时,如果__index是一个table,会查找__index元方法表,若有该索引,则返回该索引的值,否则返回nil,如果__index是一个方法,会将table和索引作为参数传递给方法,return一个返回值
__newindex 给一个索引赋值,当给table中一个不存在的索引赋值时,会调用__newindex方法
注:rawget和rawset可以直接修改表,不会调用元表的元方法

猜你喜欢

转载自blog.csdn.net/qq_18192161/article/details/84556752