Lua4.0中的函数
把Lua4.0里面的函数总结出来,目的是为了和5.1中的函数进行区分,由于工作中经常使用到4.0中的函数,所以列出来也便于查询和学习
标准库
_ALERT
_ERRORMESSAGE
call
collectgarbage
功能:是垃圾收集器的通用接口,用于操作垃圾收集器
copytagmethods
dofile (filename)
功能:打开并且执行一个lua块,当忽略参数filename时,将执行标准输入设备(stdin)的内容。返回所有块的返回值。当发生错误时,dofile将错误反射给调用者
注:dofile不能在保护模式下运行
dostring
功能:执行一个字符串形式的lua块
error (message [, level])
功能:终止正在执行的函数,并返回message的内容作为错误信息(error函数永远都不会返回)
通常情况下,error会附加一些错误位置的信息到message头部.
Level参数指示获得错误的位置,
Level=1[默认]:为调用error位置(文件+行号)
Level=2:指出哪个调用error的函数的函数
Level=0:不添加错误位置信息
foreachi(table, function(i, v))
功能:会期望一个从 1(数字 1)开始的连续整数范围,遍历table中的key和value逐对进行function(i, v)操作,与lua5.1中的用法相同
foreach
功能:与foreachi不同的是,foreach会对整个表进行迭代,与lua5.1中的用法相同
gcinfo
getflobal
gettagmethod
globals
newtag
next
print (...)
功能:简单的以tostring方式格式化输出参数的内容
rawget
rawset
rawgettable
rawsettable
setglobal
settag
settagmethod
tag
tonumber (e [, base])
功能:尝试将参数e转换为数字,当不能转换时返回nil
base(2~36)指出参数e当前使用的进制,默认为10进制,如tonumber(11,2)=3
tostirng(e)
功能:将参数e转换为字符串,此函数将会触发元表的__tostring事件
type(v)
功能:返回参数的类型名("nil","number", "string", "boolean", "table", "function", "thread", "userdata")
assert(v [, message])
功能:相当于C的断言,
参数:
v:当表达式v为nil或false将触发错误,
message:发生错误时返回的信息,默认为"assertion failed!"
getn(table)
功能:返回table中元素的个数,用法与lua5.1中的table.getn相同
sort(table, function)
功能:给定的table进行升序排序,用法与lua5.1中的table.sort相同
tinsert(table, [pos,] value)
功能:向table中插入一个元素,用法与lua5.1中的table.insert相同
tremove(table[, pos])
功能:删除table中的某一元素,用法与lua5.1中的table.remove相同
--------------------------------------------------------
输入输出库 io库
colck
功能:返回一个程序使用CPU时间的一个近似值,同lua5.1中使用方法
date
功能:功能:返回一个按format格式化日期、时间的字串或表,同lua5.1中使用方法
execute
功能:相当于C的system函数,返回系统状态码,同lua5.1中使用方法
exit
功能:相当于C的exit函数,终止主程序,code为返回值,同lua5.1中使用方法
getenv
功能:返回当前进程的环境变量varname的值,若变量没有定义时返回nil,同lua5.1中使用方法
remove
功能:删除文件或一个空目录,若函数调用失败则返加nil加错误信息,同lua5.1中使用方法
rename
功能:更改一个文件或目录名,若函数调用失败则返加nil加错误信息,同lua5.1中使用方法
setlocale
功能:设置程序的当前设置,函数返回最新的值,失败则返回nil,同lua5.1中使用方法
tmpname
功能:返回一个临时文件名,同lua5.1中使用方法
debug
功能:进入交互式的调试模式,解释我们的输入,输入cont回车就退出
appendto
openfile(file, mod)
功能:打开一个文件,返回一个文件句柄。有两个参数,文件名和打开模式
参数:file文件名
参数:mode有下列几种形态字符串:
r 打开只读文件,该文件必须存在。
r+ 打开可读写的文件,该文件必须存在。
rb+ 读写打开一个二进制文件,只允许读写数据。
rt+ 读写打开一个文本文件,允许读和写。
w 打开只写文件,若文件存在则文件长度清为0,即该文件内容会消失。若文件不存在则建立该文件。
w+ 打开可读写文件,若文件存在则文件长度清为零,即该文件内容会消失。若文件不存在则建立该文件。
a 以附加的方式打开只写文件。若文件不存在,则会建立该文件,如果文件存在,写入的数据会被加到文件尾,即文件原先的内容会被保留。
a+ 以附加方式打开可读写的文件。若文件不存在,则会建立该文件,如果文件存在,写入的数据会被加到文件尾后,即文件原先的内容会被保留。
wb 只写打开或新建一个二进制文件;只允许写数据。
wb+ 读写打开或建立一个二进制文件,允许读和写。
wt+ 读写打开或着建立一个文本文件;允许读写。
at+ 读写打开一个文本文件,允许读或在文本末追加数据。
ab+ 读写打开一个二进制文件,允许读或在文件末追加数据。
例如:
local f = openfile("abc.txt", "rb")
closefile(f)
功能:关闭打开文件的句柄
read(f, readtype)
功能:从一个打开的文件中读取数据。
参数:f是打开的文件句柄
参数:readtype表示要读取的方式
"*a"表示读取整个文件内容
"*l"表示读一行
"*n"表示读一个数字
"*w"表示读一个单词
例如:
local f = openfile("d:\\test\\test\\test.cpp", "rb");
assert(f)
local data = read(f, "*l");
print(data)
输出:this is the first line!
readfrom
seek(file, seekmod, pos)
功能:移动文件指针
参数:f是打开的文件句柄
参数:移动模式
set是设置指针移动的位置,第三个参数是具体要移动的位置
cur是从指针当前位置移动,第三个参数是具体要移动的位置,可以为负,表示前移
end是移动到文件结果,无第三个参数
例如:
local f = openfile("d:\\test\\test\\test.cpp", "rb");
seek(f, "set", 10);
seek(f, "cur", 8);
seek(f, "end");
local data = read(f, "*l");
print(data);
closefile(f);
write(file, data)
功能:向一个文件中写入数据
参数:文件句柄
参数:要写入文件的数据
例如:
local f = openfile("d:\\readme.txt", "wb");
assert(f)
write(f, "abcde")
closefile(f)
writeto
flush(f)
功能: 清除文件缓冲区,文件以写方式打开时将缓冲区内容写入文件
--------------------------------------------------------
数学库 math库
abs
功能:取绝对值
sin
功能:正弦函数
cos
功能:余弦函数
tan
功能:正切函数
asin
功能:反正弦函数
acos
功能:余弦函数
atan
功能:反正切函数
atan2
功能:x / y的反正切值
ceil
功能:不小于x的最大整数
floor
功能:不大于x的最大整数
mod
功能:取模运算
frexp
功能:把双精度数val分解为数字部分(尾数)和以2为底的指数n,即val=x*2n
ldexp
功能:计算value * 2的n次方
sqrt
功能:开平方函数
min
功能:取得参数中最小值
max
功能:取得参数中最大值
log
功能:计算一个数字的自然对数
log10
功能:计算以10为基数的对数
exp
功能:计算以e为底x次方值
deg
功能:弧度转角度
rad
功能:角度转弧度
random
功能:获取随机数
randomseed
功能:设置随机数种子
============================================================
字符串库 string库
strlen(str)
功能:获得字符串的长度
strlen("abcdefghijklmn")
输出:14
---------------------------------------
strsub(str, nStart, nEnd)
功能:截取字符串
strsub("abcdefghijklmn", 4, 7)
输出:defg
---------------------------------------
strlower(str)
功能:字符串转小写
strlower("AbCdEFg")
输出:abcdefg
---------------------------------------
strupper(str)
功能:字符串转大写
strupper("AbCdEFg")
输出:ABCDEFG
----------------------------------------
strchar(byte1, byte2, ..)
功能:数字转字符串
strchar(97, 98, 99)
输出:abc
----------------------------------------
strrep(str, nCount)
功能:返回一个指定数目拼接在一起的字符串
strrep("hello", 5)
输出:hellohellohellohellohello
---------------------------------------
ascii(str)
功能:字符串转数字
注意:若传入多个字符组成的字符串,只返回第一个字符的ascii码
ascii("a")
ascii("abc")
输出:97
---------------------------------------
strbyte(str)
功能:字符串转数字
注意:若传入多个字符组成的字符串,只返回第一个字符的ascii码
strbyte("a")
strbyte("abc")
输出:97
------------------------------------------
format(str, "格式化字符串")
功能:返回一个指定格式的格式化字符串
format("%s is %s ,has %s apples!", "Henry", "farmer", 19)
输出:Henry is farmer ,has 19 apples!
-----------------------------------------------------------
strfind(str, substr[, nStart])
功能:查找一个字符串在另一个字符串中的位置,参数3可以指定开始查找的位置
strfind("aaa hello, mike! hello", "hello", 8)
输出:19 23
------------------------------------------------------------
gsub(str, perttem, repl[, n])
功能:在str查找等于或类似perttem格式的字符串,用repl替换,参数4可选,为替换的次数
注意:该函数支持字符串匹配操作,返回的第2个值表示替换了多少次
gsub("hello, world", "%w+", "xxx")
输出:
xxx, xxx 2
--------------------------------------------------------
调试库 debug库
getlocal
getinfo
setcallhook
setlinehook
setlocal