基本函数库为Lua内置的函数库,不需要额外装载

assert (v [, message])
功能:相当于C的断言,
参数:
v:当表达式v为nil或false将触发错误,
message:发生错误时返回的信息,默认为"assertion failed!"


--------------------------------------------------------------------------------

collectgarbage (opt [, arg])
功能:是垃圾收集器的通用接口,用于操作垃圾收集器
参数:
opt:操作方法标志
"Stop": 停止垃圾收集器 
"Restart": 重启垃圾收集器 
"Collect": 执行一次全垃圾收集循环
"Count": 返回当前Lua中使用的内存量(以KB为单位)
"Step": 单步执行一个垃圾收集. 步长 "Size" 由参数arg指定 (大型的值需要多步才能完成),如果要准确指定步长,需要多次实验以达最优效果。如果步长完成一次收集循环,将返回True
"Setpause": 设置 arg/100 的值作为暂定收集的时长 
"Setstepmul": 设置 arg/100 的值,作为步长的增幅(即新步长=旧步长*arg/100)


--------------------------------------------------------------------------------

dofile (filename)
功能:打开并且执行一个lua块,当忽略参数filename时,将执行标准输入设备(stdin)的内容。返回所有块的返回值。当发生错误时,dofile将错误反射给调用者
注:dofile不能在保护模式下运行


--------------------------------------------------------------------------------

error (message [, level])
功能:终止正在执行的函数,并返回message的内容作为错误信息(error函数永远都不会返回)
通常情况下,error会附加一些错误位置的信息到message头部.
Level参数指示获得错误的位置,
Level=1[默认]:为调用error位置(文件+行号)
Level=2:指出哪个调用error的函数的函数
Level=0:不添加错误位置信息


--------------------------------------------------------------------------------

_G全局环境表(全局变量)
功能:记录全局环境的变量值的表 _G._G = _G


--------------------------------------------------------------------------------

getfenv(f)
功能:返回函数f的当前环境表
参数:f可以为函数或调用栈的级别,级别1[默认]为当前的函数,级别0或其它值将返回全局环境_G


--------------------------------------------------------------------------------

getmetatable(object)
功能:返回指定对象的元表(若object的元表.__metatable项有值,则返回object的元表.__metatable的值),当object没有元表时将返回nil


--------------------------------------------------------------------------------

ipairs (t)
功能:返回三个值 迭代函数、表、0
多用于穷举表的键名和键值对
如:for i,v in ipairs(t) do 

end
每次循环将索引赋级i,键值赋给v
注:本函数只能用于以数字索引访问的表 如:t={"1","cash"}


--------------------------------------------------------------------------------

load (func [, chunkname])
功能:装载一个块中的函数,每次调用func将返回一个连接前一结的字串,在块结尾处将返回nil
当没有发生错误时,将返回一个编译完成的块作为函数,否则返回nil加上错误信息,此函数的环境为全局环境
chunkname用于错误和调试信息


--------------------------------------------------------------------------------

loadfile ([filename])
功能:与load类似,但装载的是文件或当没有指定filename时装载标准输入(stdin)的内容


--------------------------------------------------------------------------------

loadstring (string [, chunkname])
功能:与load类似,但装载的内容是一个字串
如:assert(loadstring(s))()


--------------------------------------------------------------------------------

next (table [, index])
功能:允许程序遍历表中的每一个字段,返回下一索引和该索引的值。
参数:table:要遍历的表
   index:要返回的索引的前一索中的号,当index为nil[]时,将返回第一个索引的值,当索引号为最后一个索引或表为空时将返回nil
注:可以用next(t)来检测表是否为空(此函数只能用于以数字索引的表与ipairs相类似)


--------------------------------------------------------------------------------

ipairs (t)
功能:返回三个值 next函数、表、0
多用于穷举表的键名和键值对
如:for n,v in pairs(t) do 

end
每次循环将索引赋级i,键值赋给v
注:本函数只能用于以键名索引访问的表 如:t={id="1",name="cash"}


--------------------------------------------------------------------------------

pcall (f, arg1, ···)
功能:在保护模式下调用函数(即发生的错误将不会反射给调用者)
当调用函数成功能返回true,失败时将返回false加错误信息


--------------------------------------------------------------------------------

print (···)
功能:简单的以tostring方式格式化输出参数的内容


--------------------------------------------------------------------------------

rawequal (v1, v2)
功能:检测v1是否等于v2,此函数不会调用任何元表的方法


--------------------------------------------------------------------------------

rawget (table, index)
功能:获取表中指定索引的值,此函数不会调用任何元表的方法,成功返回相应的值,当索引不存在时返回nil
注:本函数只能用于以数字索引访问的表 如:t={"1","cash"}


--------------------------------------------------------------------------------

rawset (table, index, value)
功能:设置表中指定索引的值,此函数不会调用任何元表的方法,此函数将返回table


--------------------------------------------------------------------------------

select (index, ···)
功能:当index为数字将返回所有index大于index的参数:如:select(2,"a","b") 返回 "b"
当index为"#",则返回参数的总个数(不包括index)


--------------------------------------------------------------------------------

setfenv (f, table)
功能:设置函数f的环境表为table
参数:f可以为函数或调用栈的级别,级别1[默认]为当前的函数,级别0将设置当前线程的环境表


--------------------------------------------------------------------------------

setmetatable (table, metatable)
功能:为指定的table设置元表metatable,如果metatable为nil则取消table的元表,当metatable有__metatable字段时,将触发错误
注:只能为LUA_TTABLE 表类型指定元表


--------------------------------------------------------------------------------

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")


--------------------------------------------------------------------------------

unpack (list [, i [, j]])
功能:返回指定表的索引的值,i为起始索引,j为结束索引
注:本函数只能用于以数字索引访问的表,否则只会返回nil 如:t={"1","cash"}


--------------------------------------------------------------------------------

_VERSION
功能:返回当前Lua的版本号"Lua 5.1". 


--------------------------------------------------------------------------------

xpcall (f, err)
功能:与pcall类似,在保护模式下调用函数(即发生的错误将不会反射给调用者)
但可指定一个新的错误处理函数句柄

当调用函数成功能返回true,失败时将返回false加err返回的结果


--------------------------------------------------------------------------------


Math库


math.randomseed(os.time())


功能:os.time函数返回一个表示当前系统时间的数字,通常是自新纪元以来的一个整数。

---------------------------------------------------------------------------------


math.random()

功能:用来产生伪随机数,有三种调用方式:

第一:不带参数,将产生 [0,1)范围内的随机数.第二:带一个参数n,将产生1 <= x <= n范围内的随机数x.第三:带两个参数a和b,将产生a <= x <= b范围内的随机数x.你可以使用randomseed设置随机数发生器的种子,只能接受一个数字参数。通常在程序开始时,使用固定的种子初始化随机数发生器,意味着每次运行程序,将产生相同的随机数序列。为了调试方便,这很有好处,但是在游戏中就意味着每次运行都拥有相同的关卡。解决这个问题的一个通常的技巧是使用当前系统时间作为种子

----------------------------------------------------------------------------------

table库


table.getn()

功能:返回array的大小;

-----------------------------------------------------------------------------------

table.insert()

功能:一个数组{10,20,30},调用table.insert(a,1,15)后,a变为{15,10,20,30}。table.insert函数在array指定位置插入一个元素,并将后面所有其他的元素后移,我们不带位置参数调用insert,将会在array最后位置插入元素


-----------------------------------------------------------------------------------

table.remove()

功能:函数删除数组中指定位置的元素,并返回这个元素,所有后面的元素前移,并且数组的大小改变。不带位置参数调用的时候,他删除array的最后一个元素。

-----------------------------------------------------------------------------------

table.sort()

功能:有两个参数:存放元素的array和排序函数。排序函数有两个参数并且如果在array中排序后第一个参数在第二个参数前面,排序函数必须返回true。如果未提供排序函数,sort使用默认的小于操作符进行比较。

-----------------------------------------------------------------------------------


table.foreachi(表, function(i, v))

功能:

        会期望一个从 1(数字 1)开始的连续整数范围。

        遍历table中的key和value逐对进行function(i, v)操作

举例:

        t = {2,4,6, la = "hello", lb = "world", 8,10,12, lc = "hehe"}

        table.foreachi(t, print)

            -- 输出结果

                1    2

                2    4

6

8

                5    10

                6    12

-----------------------------------------------------------------------------------

table.foreach(表, function(i, v))

功能:

        与foreachi不同的是,foreach会对整个表进行迭代。

举例:

        t = {2,4,6, la = "hello", lb = "world", 8,10,12, lc = "hehe"}


        table.foreach(t, print)

            -- 输出结果

                1    2

                2    4

                3    6

                4    8

                5    10

                6    12

                lb   world

                lc   hehe

                la   hello


-----------------------------------------------------------------------------------



string库


string.len(s)

功能:返回字符串s的长度;

string.rep(s, n)

功能:返回重复n次字符串s的串;你使用string.rep("a", 2^20)可以创建一个1M bytes的字符串(比如,为了测试需要)

string.lower(s)

功能:将s中的大写字母转换成小写(string.upper将小写转换成大写)

string.sub(s,i,j)

功能:函数截取字符串s的从第i个字符到第j个字符之间的串。Lua中,字符串的第一个字符索引从1开始。你也可以使用负索引,负索引从字符串的结尾向前计数:-1指向最后一个字符,-2指向倒数第二个,以此类推。

string.char,string.byte

功能:用来将字符在字符和数字之间转换。string.char获取0个或多个整数,将每一个数字转换成字符,然后返回一个所有这些字符连接起来的字符串。string.byte(s, i)将字符串s的第i个字符的转换成整数;第二个参数是可选的,缺省情况下i=1。

print(string.char(97))                    --> a

i = 99; print(string.char(i, i+1, i+2))   --> cde

print(string.byte("abc"))                 --> 97

print(string.byte("abc", 2))              --> 98

print(string.byte("abc", -1))             --> 99



string.format()

在用来对字符串进行格式化的时候,特别是字符串输出,是功能强大的工具。这个函数有两个参数,使用和C语言的printf函数几乎一模一样,你完全可以照C语言的printf来使用这个函数。第一个参数为格式化串:由指示符和控制格式的字符组成。指示符后的控制格式的字符可以为:十进制'd';十六进制'x';八进制'o';浮点数'f';字符串's'。在指示符'%'和控制格式字符之间还可以有其他的选项:用来控制更详细的格式,比如一个浮点数的小数的位数

print(string.format("<%s>%s</%s>", tag, title, tag))


string.find(字符串查找)

用来在目标串(subject string)内搜索匹配指定的模式的串。函数如果找到匹配的串返回他的位置,否则返回nil。string.find函数第三个参数是可选的:标示目标串中搜索的起始位置。

string.gsub(全局字符串替换)

函数有三个参数:目标串,模式串,替换串。他基本作用是用来查找匹配模式的串,并将使用替换串其替换掉。第四个参数是可选的,用来限制替换的范围。string.gsub的第二个返回值表示他进行替换操作的次数。

s = string.gsub("Lua is cute", "cute", "great")

print(s)      --> Lua is 

_, count = string.gsub(str," ", " ")



string.gfind(全局字符串查找)