Lua基础-文件库

文件操作

Lua I\/O 库提供两种不同的方式处理文件:隐式文件描述,显式文件描述。

这些文件 I\/O 操作,在 OpenResty 的上下文中对事件循环是会产生阻塞效应。 OpenResty 比较擅长的是高并发网络处理,在这个环境中,任何文件的操作,都将阻塞其他并行执行的请求。实际中的应用,在 OpenResty 项目中应尽可能让网络处理部分、文件 I\/0 操作部分相互独立,不要揉和在一起。

隐式文件描述

设置一个默认的输入或输出文件,然后在这个文件上进行所有的输入或输出操作。所有的操作函数由 io 表提供。

打开已经存在的 test1.txt 文件,并读取里面的内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
file = io.input("test1.txt")    -- 使用 io.input() 函数打开文件

repeat
line = io.read() -- 逐行读取内容,文件结束时返回nil
if nil == line then
break
end
print(line)
until (false)

io.close(file) -- 关闭文件

--> output
my test file
hello
lua

test1.txt 文件的最后添加一行 “hello world”

1
2
3
4
file = io.open("test1.txt", "a+")   -- 使用 io.open() 函数,以添加模式打开文件
io.output(file) -- 使用 io.output() 函数,设置默认输出文件
io.write("\nhello world") -- 使用 io.write() 函数,把内容写到文件
io.close(file)

在相应目录下打开test1.txt文件,查看文件内容发生的变化。

显式文件描述

使用 file:XXX() 函数方式进行操作,其中 file 为 io.open() 返回的文件句柄。

打开已经存在的 test2.txt 文件,并读取里面的内容

1
2
3
4
5
6
7
8
9
10
11
file = io.open("test2.txt", "r")    -- 使用 io.open() 函数,以只读模式打开文件

for line in file:lines() do -- 使用 file:lines() 函数逐行读取文件
print(line)
end

file:close()

-->output
my test2
hello lua

在 test2.txt 文件的最后添加一行 “hello world”

1
2
3
file = io.open("test2.txt", "a")  -- 使用 io.open() 函数,以添加模式打开文件
file:write("\nhello world") -- 使用 file:open() 函数,在文件末尾追加内容
file:close()

在相应目录下打开test2.txt文件,查看文件内容发生的变化。

文件操作函数

io.open (filename [, mode])

按指定的模式 mode,打开一个文件名为filename的文件,成功则返回文件句柄,失败则返回 nil 加错误信息。模式:

mode

模式字符串后面可以有一个 ‘b’,用于在某些系统中打开二进制文件。

注意 “w” 和 “wb” 的区别

  • “w” 表示文本文件。某些文件系统(如 Linux 的文件系统)认为 0x0A 为文本文件的换行符,Windows 的文件系统认为 0x0D0A 为文本文件的换行符。为了兼容其他文件系统(如从 Linux 拷贝来的文件),Windows 的文件系统在写文件时,会在文件中 0x0A 的前面加上 0x0D。使用 “w”,其属性要看所在的平台。

  • “wb” 表示二进制文件。文件系统会按纯粹的二进制格式进行写操作,因此也就不存在格式转换的问题。(Linux 文件系统下 “w” 和 “wb” 没有区别)

file:close ()

关闭文件。注意:当文件句柄被垃圾收集后,文件将自动关闭。句柄将变为一个不可预知的值。

io.close ([file])

关闭文件,和 file:close() 的作用相同。没有参数 file 时,关闭默认输出文件。

file:flush ()

把写入缓冲区的所有数据写入到文件 file 中。

io.flush ()

相当于 file:flush(),把写入缓冲区的所有数据写入到默认输出文件。

io.input ([file])

当使用一个文件名调用时,打开这个文件(以文本模式),并设置文件句柄为默认输入文件;
当使用一个文件句柄调用时,设置此文件句柄为默认输入文件;
当不使用参数调用时,返回默认输入文件句柄。

file:lines ()

返回一个迭代函数,每次调用将获得文件中的一行内容,当到文件尾时,将返回 nil,但不关闭文件。

io.lines ([filename])

打开指定的文件 filename 为读模式并返回一个迭代函数,每次调用将获得文件中的一行内容,当到文件尾时,将返回 nil,并自动关闭文件。若不带参数时 io.lines() 等价于 io.input():lines() 读取默认输入设备的内容,结束时不关闭文件。

io.output ([file])

类似于 io.input,但操作在默认输出文件上。

file:read (…)

按指定的格式读取一个文件。按每个格式将返回一个字符串或数字,如果不能正确读取将返回 nil,若没有指定格式将指默认按行方式进行读取。格式:

read

io.read (…)

相当于 io.input():read

io.type (obj)

检测 obj 是否一个可用的文件句柄。如果 obj 是一个打开的文件句柄,则返回 “file” 如果 obj 是一个已关闭的文件句柄,则返回 “closed file” 如果 obj 不是一个文件句柄,则返回 nil。

file:write (…)

把每一个参数的值写入文件。参数必须为字符串或数字,若要输出其它值,则需通过 tostring 或 string.format 进行转换。

io.write (…)

相当于 io.output():write。

file:seek ([whence] [, offset])

设置和获取当前文件位置,成功则返回最终的文件位置(按字节,相对于文件开头),失败则返回 nil 加错误信息。缺省时,whence 默认为 “cur”,offset 默认为 0。
参数 whence:

whence

file:setvbuf (mode [, size])

设置输出文件的缓冲模式。模式:

buf

最后两种模式,size 可以指定缓冲的大小(按字节),忽略 size 将自动调整为最佳的大小。

原文
https://moonbingbing.gitbooks.io/openresty-best-practices/content/lua/file.html