Lua学习笔记：库函数-拓冰企业网站定制

基础函数

asset

断言。不为真则终止后续执行。

asset(BOOL <, MESSAGE>)

ipairs

用于遍历表（数组形式）。

for i, v in ipairs(TABLE) do

end

实际返回：next, TABLE, 0。

用于遍历表。

local NEXTINDEX, NEXTVALUE = next(TABLE <, INDEX>)

pairs

用于遍历表（哈希表形式）。

for k, v in pairs(TABLE) do

end

实际返回：next, TABLE, nil。

print

打印。

print(<VALUE<, ...>>)

tostring

转换成字符串。

local STR = tostring(VALUE)

type

返回数据类型。

local STR = type(VALUE)

coroutine

coroutine.create

创建协程。不会启动协程。

local COROUTINE = coroutine.create(FUNCTION)

coroutine.resume

恢复执行协程。

local STATUS, RETURNVALUE<, ...>|YIELDVALUE<, ...>|FAIL = coroutine.resume(COROUTINE <, RESUMEVALUE<, ...>>)

第一次执行时，RESUMEVALUE作为coroutine.create的FUNCTION的参数传入。后续执行时，RESUMEVALUE作为coroutine.yield的返回值。

当协程正常退出或让出时，返回true及退出或让出时的返回值；当协程非正常退出时，返回false和错误信息。

coroutine.wrap

创建协程，返回包装函数。

local WRAPFUNCTION = coroutine.wrap(FUNCTION)

WRAPFUNCTION类似coroutine.resume，但参数只包括RESUMEVALUE，返回值只包括RETURNVALUE|YIELDVALUE。

coroutine.yield

暂停协程，让出执行权。

local RESUMEVALUE<, ...> = coroutine.yield(<YIELDVALUE <, ...>>)

io

API有两种风格：一种是基于文件句柄（io.METHOD），另一种是基于当前操作的文件（FILE:METHOD）。

io.close

关闭文件。

io.close(<FILE>)

如不指定FILE，则关闭默认输出文件。

等同于file:close()。

io.flush

将程序中的缓冲区数据刷新至文件。

io.flush()

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

io.input

设置默认输入文件。

io.input(<FILE|FILENAME>)

io.lines

以只读模式打开文件，返回迭代器函数。

local FUNCTION = io.lines(<FILENAME <, ...>>)

每次调用迭代器函数都会从文件返回一行。当泛型for循环结束时，会自动关闭文件。

io.open

打开文件。

local FILE <, FAIL> = io.open(FILE <, MODE>)

如打开失败，则返回nil。

io.output

设置默认输出文件。

io.output(<FILE|FILENAME>)

io.popen

运行外部进程，并返回从此进程读写的文件句柄。

local FILE = io.popen(PROGRAM <, MODE>)

MODE可为：

a：追加。
r：只读。
w：只写。会清空文件。
a+：读写追加。
r+：读写。不清空文件，但会写覆盖。
w+：读写。会清空文件。

io.read

从文件读取内容。

local STR = io.read(<FORMAT>)

FORMAT可为：

a：读取余下所有内容。
l：读取一行，不包括换行符。默认值。
L：读取一行，包括换行符。
n：读取一个数值。
整数：读取若干字节。

等同于io.input().read(<FORMAT>)。

io.tmpfile

返回可读写的临时文件。进程结束时会被自动删除。

local FILE = io.tmpfile()

io.type

返回文件的状态类型。

var STR = io.type(FILE)

返回值可为：

closed file：关闭的文件。
file：打开的文件。
nil：文件句柄不存在。

io.write

写入文件。

io.write(<STR|NUMBER <, ...>>)

FILE:close

关闭文件。

FILE:close()

FILE:flush

将缓冲区数据刷新至文件。

FILE:flush()

FILE:lines

以只读模式打开文件，返回迭代器函数。

local FUNCTION = FILE:lines(<FILENAME <, ...>>)

每次调用迭代器函数都会从文件返回一行。当泛型for循环结束时，不会自动关闭文件。

FILE:read