Lua中的一些常用函数库实例讲解

前言

这篇文章将会来一些比较轻松的内容，就是简单的介绍一下Lua中几个常用的库。简单的说就是几个API的介绍。所以说，看起来比较容易，也没有多大的分量。就是纯粹的总结。使用库就是为了方便我们的开发，提高开发效率，同时也能保证代码的质量。希望大家以后也不要重复造轮子了。

数学库

数学库（math）由一组标准的数学函数构成。这里主要介绍几个常用的函数，其它的大家可以自行百度解决。

三角函数（sin,cos,tan……）

所有的三角函数都使用弧度单位，可以用函数deg（角度）和rad（弧度）来转换角度和弧度。示例代码：

复制代码 代码如下:

print(math.sin(math.rad(30))) -- 0.5

谨记：三角函数的参数都是弧度，在实际使用中不要忘了，是弧度。

取整函数（floor,ceil）

floor：返回不大于x的最大整数；向下取整；
ceil：返回不小于x的最大整数；向上取整。示例代码：

复制代码 代码如下:

print(math.floor(5.6)) -- 5
print(math.ceil(5.6)) -- 6

最大值和最小值（max,min）

max：取参数中的最大值；
min：取参数中的最小值。示例代码：

复制代码 代码如下:

print(math.max(2, 3, 2, 14, 2, 30, -3)) -- 30
print(math.min(2, 3, 2, 14, 2, 30, -3)) -- -3

生成伪随机数的函数（random,randomseed）

在实际开发中，生成随机数的需求是经常有的。使用random和randomseed这两个函数就可以轻易的完成。math.random用于生成伪随机数，可以用3种方式来调用它：
（1）如果在调用时不提供任何参数，它将返回一个在区间[0, 1)内均匀分布的伪随机实数；
（2）如果提供了一个整数n作为参数，它将返回一个在区间[1, n]内的伪随机整数；
（3）如果提供了两个整数参数m和n，它将返回一个在区间[m, n]内的伪随机整数。
示例代码如下：

复制代码 代码如下:

print(math.random()) -- 输出一个大于等于0，小于1的值
print(math.random(2)) -- 输出不是1就是2
print(math.random(3, 4)) -- 输出不是3就是4

如果你按照上面的代码运行，然后再看着我写的注释，你可能就要骂我了，什么破注释了，明显就是错的么？每次运行的输出结果都是一样的。是的，结果是一样的，这就要说到即将出场的math.randomseed。函数math.randomseed用于设置伪随机数生成器的种子数。（看到这里，我姑且认为你是已经有过一年编程经验的人员了，所以，你就不要问我什么是种子了，这种概念性的东西，我想百度百科或者维基百科比我更有指导意义）math.randomseed的唯一参数就是一个我们称为种子数的值。一般我们的做法是在一个程序启动时，用一个固定的种子数来调用它，以此初始化伪随机数生成器。那么如何设置这个math.randomseed的种子值呢？如果使用同一个种子值的话，每次得到的随机数就会是一样的，在实际开发中，一般都是使用当前时间作为种子值，比如：

复制代码 代码如下:

math.randomseed(os.time())

这样就好了。一般在我们的程序启动时，初始化一次种子就足够了。我曾经傻傻的在一个循环中，使用math.random取随机数，每次都调用math.randomseed(os.time())设置种子值（为什么不可以？你可以自己试一试，看看结果。如果不懂，留下你的迷惑，我们继续交流）。

复制代码 代码如下:

math.randomseed(os.time())
print(math.random()) -- 输出一个大于等于0，小于1的值
print(math.random(2)) -- 输出不是1就是2
print(math.random(3, 4)) -- 输出不是3就是4

这样就好了，运行一下，看看结果吧。

table库

table库是由一些辅助函数构成的，这些函数将table作为数组来操作（重点：作为数组来操作的）。

插入和删除函数

table.insert用于将一个元素插入到一个数组的指定位置，它会移动后续元素以空出空间。如果在调用table.insert时没有指定位置参数，则会将元素添加到数组末尾。示例代码：

复制代码 代码如下:

local tb = {10, 20, 30}
table.insert(tb, 40) -- 在table的最后插入，结果为：{10, 20, 30, 40}
table.insert(tb, 2, 15) -- 在table的位置2插入，结果为：{10, 15, 20, 30, 40}

函数table.remove会删除并返回数组指定位置上的元素，并将该位置之后的所有元素前移，以填补空缺。如果在调用这个函数时不指定位置参数，它就会删除数组的最后一个元素。示例代码：

复制代码 代码如下:

local tb = {10, 20, 30}
print(table.remove(tb)) -- 删除最后一个元素，并返回30；最后，tb = {10, 20}
print(table.remove(tb, 1)) -- 删除第一个元素并返回10；最后，tb = {20}

现在有了这两个操作，实现数据结构中的堆栈那就轻而易举了。等什么？自己试一试吧。

排序

对数组进行排序，这种需求，在实际开发中那是100%会遇到的。所以了，不会使用Lua对数组进行排序，那是会被别人笑掉大牙的。废话少说。在Lua中，我们可以用table.sort完成这个任务。它可以对一个数组进行排序，还可以指定一个可选的次序函数。这个次序函数有两个参数，如果希望第一个参数在排序结果中位于第二个参数值前，就应当返回true；如果没有提供这个函数，table.sort就使用默认的小于操作。实例代码：

复制代码 代码如下:

local tb = {20, 10, 2, 3, 4, 89, 20, 33, 2, 3}
-- 默认是升序排序
table.sort(tb)
for _, v in ipairs(tb) do
    print(v)
end
print("=======")
 
-- 修改为降序排序
table.sort(tb, function (a, b) if a > b then return true end end)
for _, v in ipairs(tb) do
    print(v)
end

但是，在实际开发中，我们经常犯这样的错误，总是试图对一个table的索引进行排序。在table中，索引是一个无序的集合。如果对它们进行排序，则必须将它们复制到一个数组中，然后对这个数组进行排序。这就是我为什么一开始强调的，table库是对数组进行操作的。示例代码：

复制代码 代码如下:

local tb = {x = 20, z = 10, y = 30, m = 2, n = 8} -- 这是一个key无序的table
-- 如果想按照key的升序排列，下列代码是不起作用的
table.sort(tb)
for k, v in pairs(tb) do
    print(k .. " = " .. v)
end

正确做法是将这个table的所有key放入到一个数组中，对这个数组进行排序。示例代码：

复制代码 代码如下:

local tb = {x = 20, z = 10, y = 30, m = 2, n = 8} -- 这是一个key无序的table
 
local keyTb = {}
for k, _ in pairs(tb) do
    keyTb[#keyTb + 1] = k
end
 
table.sort(keyTb)
 
for _, v in ipairs(keyTb) do
    print(v .. " = " .. tb[v])
end

现在就是按照key的升序排列了。

连接

使用table.concat可以完成数组的连接。它接受一个字符串数组，并返回这些字符串连接后的结果，它有一个可选参数，用于指定插到字符串之间的分隔符，同时这个函数另外还接受两个可选参数，用于指定第一个和最后一个要连接的字符串索引。示例代码：

复制代码 代码如下:

local tb = {"Jelly", "Think", "Is", "Good"}
local strTb = table.concat(tb, " ")
print(strTb)

字符串库

重点来了，学习每种语言，在实际工作时，我们总是在和字符串进行打交道。Lua也不例外，在Lua中真正的字符串操作能力来源于字符串库，字符串库中的所有函数都导出在模块string中。现在就来对string库进行总结。

基础字符串函数

直接通过代码来说吧，示例代码：

复制代码 代码如下:

local str = "Jelly Think"
-- string.len可以获得字符串的长度
local len = string.len(str)
print(len) -- 11
 
-- string.rep返回字符串重复n次的结果
str = "ab"
local newStr = string.rep(str, 2) -- 重复两次
print(newStr) -- abab
 
-- string.lower将字符串小写变成大写形式，并返回一个改变以后的副本
str = "Jelly Think"
newStr = string.lower(str)
print(newStr) -- jelly think
 
-- string.upper将字符串大写变成小写形式，并返回一个改变以后的副本
newStr = string.upper(str)
print(newStr) -- JELLY THINK

这里重点介绍一下string.sub(s, i, j)函数，它可以从字符串s中提取第i个到第j个字符。在Lua中，字符串的第一个字符的索引是1，但是，索引也可以是负数，表示从字符串的尾部开始计数，索引-1代表字符串的最后一个字符，以此类推。

复制代码 代码如下:

local str = "[Jelly Think]"
local newStr = string.sub(str, 2, -2)
print(newStr) -- Jelly Think
newStr = string.sub(str, 2, 6)
print(newStr) -- Jelly

（重点：在Lua中，字符串和其它语言的一样，是不可变的，以上的操作，都会返回一个新的值，但并不会修改原来的字符串。谨记，谨记！！！）
函数string.char和函数string.byte用于转换字符及其内部数值表示；string.char函数接受零个或多个整数，并将每个整数转换成对应的字符，然后返回一个由这些字符连接而成的字符串。string.byte(s, i)返回字符串s中第i个字符的内部数值表示，它的第二个参数是可选的，调用string.byte(s)可返回字符串s中第一个字符的内部数值表示。示例代码：

复制代码 代码如下:

print(string.char(97)) -- a
local i = 98
print(string.char(i, i + 1, i + 2)) -- bcd
print(string.byte("abc")) -- 97
print(string.byte("abc", 2)) -- 98
print(string.byte("abc", 2, 3)) -- 98 99
print(string.byte("abc", -1)) -- 99

在Lua中也有一个神奇的函数，string.format。和C语言中的printf是一致的。之所以说它神奇，因为它用的太多了，也太好用了。以至于我这里就不多废话了，我相信你们都会的。

模式匹配

由于模式匹配的东西比较多，所以，准备单独写篇博文单独总结。

I/O库

I/O库为文件操作提供了两种不同的模型，简单模型和完整模型。简单模型假设有一个当前输入文件和一个当前输出文件，它的I/O操作均作用于这些文件。完整模型则使用显式地文件句柄。它采用了面向对象的风格，并将所有的操作定义为文件句柄上的方法。

简单I/O模型

简单模型的所有操作都作用于两个当前文件。I/O库将当前输入文件初始化为进程标准输入（stdin），将当前输出文件初始化为进程标准输出。在执行io.read()操作时，就会从标准输入中读取一行。

用函数io.input和io.output可以改变这两个当前文件。io.input(filename)调用会以只读模式打开指定的文件，并将其设定为当前输入文件；除非再次调用io.input，否则所有的输入都将来源于这个文件；在输出方面，io.output也可以完成类似的工作。说完了input和output，在来聊聊io.write和io.read。

io.write接受任意数量的字符串参数，并将它们写入当前输出文件；它也可以接受数字参数，数字参数会根据常规的转换规则转换为字符串。如果希望有更多的控制，可以使用string.format进行控制。函数io.read从当前输入文件中读取字符串，它的参数决定了要读取的数据：

“*all”	读取整个文件
“*line”	读取下一行
“*number”	读取一个数字
<num>	读取一个不超过<num>个字符的字符串

直接看一段示例代码吧：

复制代码 代码如下:

-- 先建立input.txt和output.txt两个文件
-- 在input.txt文件中写入以下内容：
--[[
http://www.jb51.net
果冻想 | 一个原创文章分享网站
88
--]]
io.input("input.txt") -- 从input.txt文件中读取
io.output("output.txt") -- 写入到output.txt文件
-- 向input.txt写入一些测试数据
io.write("JellyThink", "\n")
io.write("果冻想", "\n")
io.write("http://www.jb51.net", "\n")
io.write(88)

读取一整个文件的示例代码：

复制代码 代码如下:

str = io.read("*all") -- 读取所有
--[[
print(str)
http://www.jb51.net
果冻想 | 一个原创文章分享网站
88
--]]
print(str)

每次读取一行的示例代码：

复制代码 代码如下:

-- 用来判断是否已经读到了文件末尾
-- 如果已经到了末尾，就返回nil;否则返回空字符串
local mark = io.read(0)
while mark do
    print(io.read("*line"))
    mark = io.read(0)
    if not mark then
        print("File end.")
        break
    end
end

完整I/O模型

简单I/O功能太受限了，以至于基本没有什么用处，而用的更多的则是这里说的完整I/O模型。完整I/O模型可以进行更多的I/O控制，它是基于文件句柄的，就好比与C语言中的FILE*，表示一个正在操作的文件。

要打开一个文件，可以使用io.open函数，它有两个参数，一个表示要打开的文件名，另一个表示操作的模式字符串。模式字符串可以有以下四种取值方式：

（1）”r”：以读取方式打开文件；只能对文件进行读取操作；
（2）”w”：以写入方式打开文件；可以对文件进行写入操作，但是会覆盖文件原有内容；
（3）”a”：以追加方式打开文件；可以对文件进行写入操作；会在原来文件的基础在，进行追加写入；
（4）”b”：表示打开二进制文件，这种模式一般都是和前面三种混合使用，比如：”rb”,”wb”。

open函数会返回表示文件的一个句柄；如果发生错误，就返回nil，一条错误消息和一个错误代码。示例代码：

复制代码 代码如下:

-- 访问一个不存在的文件
print(io.open("ooxx.txt", r))
--[[
输出以下内容:
nil    ooxx.txt: No such file or directory    2
--]]

当成功打开一个文件以后，就可以使用read/write方法读写文件了，这与read/write函数相似，但是需要用冒号语法，将它们作为文件句柄的方法来调用，示例代码：

复制代码 代码如下:

local hFile = io.open("input.txt", r)
if hFile then
    local strContent = hFile:read("*all")
    --local strContent = hFile.read(hFile, "*all") 你也可以使用这种方法
    print(strContent)
end

我们也可以将完整I/O模式与简单I/O模式混合使用。通过不指定参数调用io.input()，可以得到当前输入文件的句柄；而通过io.input(handle)，可以设置当前输入文件的句柄，比如，需要临时改变当前输入文件，可以这样做：

复制代码 代码如下:

-- io.input()不传入参数时，获取当前的输入文件句柄
local hCurrent = io.input()
-- 打开一个新的文件
io.input("input.txt")
-- 在新的文件上进行操作
local strContent = io.read("*all")
print(strContent)
-- 关闭当前文件
io.input():close()
-- 操作完成以后，恢复到以前的状态
io.input(hCurrent)

其它文件操作

函数tmpfile返回一个临时文件的句柄，这个句柄是以读/写方式打开；这个文件会在程序结束时自动删除。我们在使用时，可以直接io.tmpfile()就ok了。
函数flush会将缓冲区中数据写入文件，它与write函数一样，将其作为一个函数调用时，io.flush()会刷新当前输出文件；而将其作为一个方法调用时，f:flush()会刷新某个特定的文件f。

函数seek可以获取和设置一个文件的当前位置。它的一般形式是f:seek(whence, offset)，其参数的具体含义如下：

（1）whence取值set，offset表示为相对于文件起始的偏移量；
（2）whence取值cur，offset表示为相对于当前位置的偏移量；
（3）whence取值end，offset表示为相对于文件末尾的偏移量。

函数的返回值与whence无关，它总是返回文件的当前位置，即相对于文件起始处的偏移字节数。根据上述的描述，来一小段示例代码：

复制代码 代码如下:

function GetFileSize(hFile)
    local currentPos = hFile:seek() -- 获取当前位置
    local size = file:seek("end") -- 获取文件大小
    file:seek("set", currentPos)
    return size
end

操作系统函数

操作系统库定义在table os中，其中包含了文件操作函数、获取当前日期和时间的函数。为了保证Lua的可移植性，所以对于文件库来说，就比较简单，它只包含两个函数：

用于文件改名的os.rename函数；
用于删除文件的os.remove函数。

但是对于获取日期和时间的函数，还是有必要花费一点时间总结一下的。

日期与时间

在Lua库中提供了两个非常重要的日期和时间函数，分别是time和date。那就先从time函数开始。

time

如果不带任何参数调用time函数，它会以数字形式返回当前的日期和时间。返回的数值表示当前时间到某个特定时间的秒数，在不同的系统上，这个特定的时间是不一样的。如果用一个table作为参数调用它，它会返回一个数字，表示该table中所描述的日期和时间。这种table具有以下有效字段：

year	一个完整的年份
month	01-12
day	01-31
hour	00-23
min	00-59
sec	00-59
isdst	一个布尔值，true表示夏令时

前三个字段是必须要有的，比如：

复制代码 代码如下:

print(os.time()) -- 输出当前时间的描述
print(os.time({year=2014,month=8,day=14}))

date

函数date是time的一个反函数，它可以将一个表示日期和时间的数字转换成某些高级的表现形式。其第一个参数是格式字符串，指定了期望的表示形式；第二个参数是日期和时间的数字，默认为当前日期和时间。例如：

复制代码 代码如下:

local tbCurrentTime = os.date("*t")
for k, v in pairs(tbCurrentTime) do
    print(k .. "=" .. tostring(v))
end

这样就会输出当天的时间，你运行以下代码看看。其实data函数没有多少需要说的。只是data函数的第一个参数的格式种类是非常多的，可以去百度一下。我一般用一个*t就够了。但是了解一下其它的也还不错。

对于这里说到的time和date两个函数，一般time函数返回的描述不适合人去读，我们一般都是保存这个数字，在后台进行处理；对于date函数，它返回的内容适合人去读，所以，一般使用date返回的数据在UI上显示。

总结

对于任何语言来说，一个标准库都是一个非常庞大的东西，Lua也是这样，所以这篇文章写的也比较长。抱歉，这只是第一部分，后面还有第二部分。所以呢，大家还是将就着看吧。虽然深的东西没有多少，但是这也是我们入门一门语言的必经之路。少年们，努力吧。