Lua OS标准库

回到:


OS库

Lua的OS库提供的功能较少。

1
2
3
4
5
6
7
8
9
10
11
12
os.exit()          --> 退出程序
os.tmpname() --> 返回一个临时文件名
os.rename() --> 文件重命名
os.remove() --> 移除文件
os.execute() --> 执行外部命令
os.getenv() --> 获取环境变量
os.setlocale() --> 设置locale

os.time() --> 获取日期时间
os.data() --> 解析日期时间为字符串或table
os.difftime() --> 计算时间差
os.clock() --> 计算代码执行时长

os.exit()

1
os.exit ([code [, close]])

退出程序。可指定退出状态码,code参数可为true、false或一个数值。

os.getenv()

1
os.getenv (varname)

获取指定环境变量varname的值,如果指定的环境变量不存在,则返回nil。

os.rename()

1
os.rename(oldname, newname)

文件重命名,如果重命名成功,返回true,否则返回nil,同时返回报错信息和错误状态码。

os.remove()

1
os.remove (filename)

删除名为filename的文件或空目录。删除成功,则返回true,否则返回nil,同时返回报错信息和错误状态码。

os.tmpname()

1
os.tmpname()

返回一个可用于操作临时文件的字符串,它会自动创建该临时文件。返回临时文件名后,该文件还必须显式打开以及显式删除。

如果可以的话,建议使用io.tmpfile()来返回一个临时文件句柄,它会在程序退出的时候自动删除。

os.execute()

1
os.execute([cmd])

该函数等价于C的system()函数。它实际上是将参数cmd传递给操作系统的shell去执行。

第一个返回值如果为true时,表示命令cmd成功执行完成,否则该返回值为nil。

第二个返回值和第三个返回值分别是描述字符串和一个数值:

  • 第二个返回值为”exit”,表示命令正常退出,此时第三个返回值为命令的退出状态码
  • 第二个返回值为”signal”:表示命令被信号终止,第三个返回值为终止该进程的信号代码

例如,创建目录:

1
os.execute("mkdir -p"..dirname)

os.clock()

返回CPU执行时长。通过它可以计算一段代码执行时CPU的耗费时间。

1
2
3
4
local start = os.clock()
local s = 0
for i = 1,10000 do s = s + i end
print(os.clock() - start)

os.time()

构建时间点。

1
os.time([table])

如果不给参数,返回当前时间点的epoch值。

如果给定一个table类型的参数,则返回对应的epoch值。

参数是一个包含如下字段的table:

  • year
  • month
  • day
  • hour(默认值为12)
  • min(默认值为0)
  • sec(默认值为0)
  • isdst(默认值为nil)

这些字段的数值大小可以不在它们的有效范围内,例如sec字段指定为-10,将自动后退10秒,hour为100,将自动进位到day甚至month。

例如:

1
2
3
4
5
6
7
8
9
10
11
os.time()
--> 1587377837

os.time({year=2017,month=10,day=12})
--> 1507780800

os.time({year=2017,month=10,day=12,hour=12,min=0,sec=1})
--> 1507780801

os.time({year=2017,month=10,day=12,hour=12,min=0,sec=-1})
--> 1507780799

os.difftime()

1
os.difftime (t2, t1)

返回时间差,单位秒,其中t2和t1都是epoch值。它等价于t2-t1。

os.date()

按一定的格式将epoch值解析成日期时间的字符串格式或table格式。

1
os.date ([format [, time]])

不指定任何参数时,以系统设置的格式返回当前时间。

1
2
os.date()
--> Mon Apr 20 18:27:37 2019

time参数是待解析的epoch时间点,如果不给定参数time,则解析当前时间。

format参数指定将epoch解析成何种格式。format参数有一个可选的格式前缀”!”,例如"!*t""!%F %T",它表示以UTC去解析epoch。

当format为"*t"时,表示将epoch转换为table,包含以下字段:

1
2
3
4
5
6
7
8
9
year
month (1–12)
day (1–31)
hour (0–23)
min (0–59)
sec (0–61)
wday (weekday, 1–7, Sunday is 1)
yday (day of the year, 1–366),
isdst (daylight saving flag, a boolean)

如果format不是"*t",则根据用户指定的格式返回对应的字符串格式。其格式和C语言支持的一样,可man strftime。

例如:

1
2
3
os.date("*t").month     --> 4

os.date("%F %T") --> 2020-04-20 19:32:39

可以将os.date("*t")结合os.time()一起使用,例如计算3天前的时间:

1
2
3
cur = os.date("*t")
cur.day = cur.day - 3
print(os.time(cur))
文章作者: 骏马金龙
文章链接: http://www.junmajinlong.com/lua/os_lib/
版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 骏马金龙
打赏我