1 Lua 标准库 - 输入输出处理(input and output facilities)
2 转载于：http://blog.csdn.net/duanxuyun
3 文本Tag： Lua
4 【IT168 技术文档】I/O库提供两种不同的方式进行文件处理
5
6 1、io表调用方式：使用io表，io.open将返回指定文件的描述，并且所有的操作将围绕这个文件描述
7
8 io表同样提供三种预定义的文件描述io.stdin,io.stdout,io.stderr
9
10 2、文件句柄直接调用方式,即使用file:XXX()函数方式进行操作,其中file为io.open()返回的文件句柄
11
12 多数I/O函数调用失败时返回nil加错误信息,有些函数成功时返回nil
13
14 1、io.close ([file])
15
16 功能：相当于file:close()，关闭默认的输出文件
17
18 2、io.flush ()
19
20 功能：相当于file:flush(),输出所有缓冲中的内容到默认输出文件
21
22 3、io.lines ([filename])
23
24 功能：打开指定的文件filename为读模式并返回一个迭代函数,每次调用将获得文件中的一行内容,当到文件尾时，将返回nil,并自动关闭文件
25
26 若不带参数时io.lines() <=> io.input():lines(); 读取默认输入设备的内容，但结束时不关闭文件
27
28 如：for line in io.lines("main.lua") do
29
30 print(line)
31
32 end
33
34 4、io.open (filename [, mode])
35
36 功能：按指定的模式打开一个文件，成功则返回文件句柄，失败则返回nil+错误信息
37
38 mode:
39
40 "r": 读模式 (默认);
41
42 "w": 写模式;
43
44 "a": 添加模式;
45
46 "r+": 更新模式，所有之前的数据将被保存
47
48 "w+": 更新模式，所有之前的数据将被清除
49
50 "a+": 添加更新模式，所有之前的数据将被保存,只允许在文件尾进行添加
51
52 "b": 某些系统支持二进制方式
53
54 5、io.output ([file])
55
56 功能：相当于io.input，但操作在默认输出文件上
57
58 6、io.popen ([prog [, mode]])
59
60 功能：开始程序prog于额外的进程,并返回用于prog的文件句柄(并不支持所有的系统平台)
61
62 7、io.read (...)
63
64 功能：相当于io.input():read
65
66 8、io.tmpfile ()
67
68 功能：返回一个临时文件句柄，该文件以更新模式打开，程序结束时自动删除
69
70 9、io.type (obj)
71
72 功能：检测obj是否一个可用的文件句柄
73
74 返回：
75
76 "file"：为一个打开的文件句柄
77
78 "closed file"：为一个已关闭的文件句柄
79
80 nil:表示obj不是一个文件句柄
81
82 10、io.write (...)
83
84 功能：相当于io.output():write
85
86 11、file:close()
87
88 功能：关闭文件
89
90 注：当文件句柄被垃圾收集后，文件将自动关闭。句柄将变为一个不可预知的值
91
92 12、file:flush()
93
94 功能：向文件写入缓冲中的所有数据
95
96 13、file:lines()
97
98 功能：返回一个迭代函数,每次调用将获得文件中的一行内容,当到文件尾时，将返回nil,但不关闭文件
99
100 如：for line in file:lines() do body end
101
102 14、file:read(...)
103
104 功能：按指定的格式读取一个文件,按每个格式函数将返回一个字串或数字,如果不能正确读取将返回nil,若没有指定格式将指默认按行方式进行读取
105
106 格式：
107
108 "*n": 读取一个数字
109
110 "*a": 从当前位置读取整个文件,若为文件尾，则返回空字串
111
112 "*l": [默认]读取下一行的内容,若为文件尾，则返回nil
113
114 number: 读取指定字节数的字符,若为文件尾，则返回nil;如果number为0则返回空字串,若为文件尾，则返回nil;
115
116 15、file:seek([whence][,offset])
117
118 功能：设置和获取当前文件位置,成功则返回最终的文件位置(按字节),失败则返回nil加错误信息
119
120 参数
121
122 whence:
123
124 "set": 从文件头开始
125
126 "cur": 从当前位置开始[默认]
127
128 "end": 从文件尾开始
129
130 offset:默认为0
131
132 不带参数file:seek()则返回当前位置,file:seek("set")则定位到文件头,file:seek("end")则定位到文件尾并返回文件大小
133
134 16、file:setvbuf(mode,[,size])
135
136 功能：设置输出文件的缓冲模式
137
138 参数
139
140 mode:
141
142 "no": 没有缓冲，即直接输出
143
144 "full": 全缓冲，即当缓冲满后才进行输出操作(也可调用flush马上输出)
145
146 "line": 以行为单位，进行输出(多用于终端设备)
147
148 最后两种模式,size可以指定缓冲的大小(按字节)，忽略size将自动调整为最佳的大小
149
150 17、file:write(...)
151
152 功能：按指定的参数格式输出文件内容，参数必须为字符或数字，若要输出其它值，则需通过tostring或string.format进行转换
