Lua IO库详解

I/O 库提供了两套不同风格的文件处理接口。 第一种风格使用隐式的文件句柄； 它提供设置默认输入文件及默认输出文件的操作， 所有的输入输出操作都针对这些默认文件。 第二种风格使用显式的文件句柄。

当使用隐式文件句柄时， 所有的操作都由表 io 提供。 若使用显式文件句柄， io.open 会返回一个文件句柄，且所有的操作都由该文件句柄的方法来提供。

表 io 中也提供了三个 和 C 中含义相同的预定义文件句柄： io.stdin io.stdout io.stderr。 I/O 库永远不会关闭这些文件。

除非另有说明， I/O 函数在出错时都返回 nil （第二个返回值为错误消息，第三个返回值为系统相关的错误码）。 成功时返回与 nil 不同的值

io:open(filename [, mode])

这个函数用字符串 mode 指定的模式打开一个文件。 返回新的文件句柄。 当出错时，返回 nil 加错误消息。
mode 字符串可以是下列任意值：

• **"r": **只读模式，这也是对已存在的文件的默认打开模式。
• **"w": **可写模式，允许修改已经存在的文件和创建新文件(不可读)。
• **"a": **追加模式，对于已存的文件允许追加新内容，但不允许修改原有内容，同时也可以创建新文件。
• **"r+": **读写模式打开已存的在文件。
• **"w+": **如果文件已存在则删除文件中数据；若文件不存在则新建文件。读写模式打开。
• **"a+": **以可读的追加模式打开已存在文件，若文件不存在则新建文件。

mode 字符串可以在最后加一个 'b' ， 这会在某些系统上以二进制方式打开文件。

当文件不存在时

local file = io.open("./test.txt")
file:close()

模式"r","r+",会提示错误,这两种模式不会自动创建为难。
模式"a","a+","w","w+"都会创建文件

当文件存在时
原文件:

test.txt
this is test 1
this is test 2

lua文件:

local file = io.open("./test.txt", mode)
print(file:write("123", "a"))
file:close()

local file = io.open("./test.txt", "r+")
print(file:read("*a"))
file:close()

对不同模式,分别调用读写操作

mode为"r"

Output:
写:
nil Bad file descriptor 9

文件可读,不可写

mode为"r+"

Output :
true

文件内容:
123a is test 1
this is test 2

文件内容保留,新内容从文件头输入
可读

mode为"w"

Output :
true

文件内容:
123a

读:
nil No error    0

用输入内容覆盖文件内容
使用"w"模式打开文件时,会立即删除文件内容,即使不写入内容.
用"w"模式读时,返回nil

mode为"w+"

Output:
true

文件内容:
123a

用输入内容覆盖文件内容
使用"w+"模式打开文件时,会立即删除文件内容
用"w+"模式读时,返回空字符串

mode为"a"

Output:
true

文件内容:
this is test 1
this is test 2123a

读:
nil No error    0

追加模式写入
不可读

mode为"a+"

Output:
true

文件内容:
this is test 1
this is test 2123a

追加模式写入
可读

---

io:input([file])

用文件名调用它时，（以文本模式）来打开该名字的文件， 并将文件句柄设为默认输入文件。 如果用文件句柄去调用它， 就简单的将该句柄设为默认输入文件。 如果调用时不传参数，它返回当前的默认输入文件。
在出错的情况下，函数抛出错误而不是返回错误码。

--文件名
io.input("./test.txt")
print(io.read("*a"))
io:close()

Output:
this is test 1
this is test 2

--文件句柄(需要使用可读模式)
local file = io.open("./test.txt", "r")
print(io.input(file))
print(io.read("*a"))
print(file)
io.close()

Output:
file (777E1BD8)
this is test 1
this is test 2
file (777E1BD8

---

io:output([file])

用文件名调用它时，（以文本模式）来打开该名字的文件， 并将文件句柄设为默认输出文件。 如果用文件句柄去调用它， 就简单的将该句柄设为默认输出文件。 如果调用时不传参数，它返回当前的默认输出文件。
在出错的情况下，函数抛出错误而不是返回错误码。

print(io.output("./test.txt"))
io.write("123")
io.close()

Output:
file (777E1BD8)

文件内容:
123

---

io.popen (prog [, mode])

这个函数和系统有关，不是所有的平台都提供。

用一个分离进程开启程序 prog， 返回的文件句柄可用于从这个程序中读取数据 （如果 mode 为 "r"，这是默认值） 或是向这个程序写入输入（当 mode 为 "w" 时）。

---

io.tmpfile()

返回一个临时文件的句柄。 这个文件以更新模式打开，在程序结束时会自动删除。

---

io.type(obj)

检查 obj 是否是合法的文件句柄。 如果 obj 它是一个打开的文件句柄，返回字符串 "file"。 如果 obj 是一个关闭的文件句柄，返回字符串 "closed file"。 如果 obj 不是文件句柄，返回 nil 。

local file = io.tmpfile()
print(io.type(file))
file:close()
print(io.type(file))
print(io.type({}))

Output:
file
closed file
nil

---

io.lines([filename])

提供一个循环迭代器以遍历文件，如果指定了文件名则当遍历结束后将自动关闭该文件；若使用默认文件，则遍历结束后不会自动关闭文件。

for line in io.lines("./test.txt") do
    print(line)
end

Output:
this is test 1
this is test 2

注:Lua 5.3 有变动,添加模式数

---

file:lines()

返回一个迭代器函数， 每次调用迭代器时，都从文件中取一行数据,和 io.lines 不同， 这个函数在循环结束后不会关闭文件。
注:Lua 5.3 有变动,添加模式数

---

file:read(...)

读文件 file， 指定的格式决定了要读什么。 对于每种格式，函数返回读出的字符对应的字符串或数字。 若不能以该格式对应读出数据则返回 nil。 （对于最后这种情况， 函数不会读出后续的格式。） 当调用时不传格式，它会使用默认格式读下一行

• *"n": ** 从文件当前位置读入一个数字，如果该位置不为数字则返回 nil。
• *"l": ** 读入当前行。
• *"a": ** 读入从当前文件指针位置开始的整个文件内容。
• number: 读入指定字节数的内容。

local file = io.open("./test.txt", "r")
print(file:read("*l"))
print(file:read("*n"))
print(file:read(2))

Output:
this is test 1
nil
th

注:Lua 5.3 有变动,去掉*号,并添加"i"和"L"格式

---

io:read(...)

等价于 io.input():read(···)。

---

file:write(...)

将参数的值逐个写入 file。 参数必须是字符串或数字。
成功时，函数返回 file。 否则返回 nil 加错误描述字符串。

---

io:write(...)

等价于 io.output():write(···)。

---

file:close()

关闭 file。 注意，文件在句柄被垃圾回收时会自动关闭， 但是多久以后发生，时间不可预期的。

---

io:close()

等价于 file:close()。 不给出 file 时将关闭默认输出文件。

---

file:flush()

将写入的数据保存到 file 中

---

io:flush()

等价于 io.output():flush()。

---

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

设置及获取基于文件开头处计算出的位置。 设置的位置由 offset 和 whence 字符串 whence 指定的基点决定。基点可以是：

• **"set": **基点为 0 （文件开头）；
• **"cur": **基点为当前位置了；
• **"end": **基点为文件尾；

当 seek 成功时，返回最终从文件开头计算起的文件的位置。 当 seek 失败时，返回 nil 加上一个错误描述字符串。

whence 的默认值是 "cur"， offset 默认为 0 。 因此，调用 file:seek() 可以返回文件当前位置，并不改变它； 调用 file:seek("set") 将位置设为文件开头（并返回 0）； 调用 file:seek("end") 将位置设到文件末尾，并返回文件大小。

local file = io.open("./test.txt", "r+")
print(file:seek("end"))
print(file:seek("set"))
print(file:seek())
print(file:seek("cur", 10))
print(file:seek("cur"))
print(file:read(1))
print(file:seek("cur"))
file:write("123")
file:close()

Output:
30
0
0
10
10
s
11

修改文件的值会影响read操作 以及以"r+"模式打开文件的write操作