Lua - 标准库
Lua 标准库提供了一组丰富的功能,这些功能直接使用C API实施,并使用 Lua 编程语言内置。
这些内置在官方 C API 中的标准库作为单独的 C 模块提供。 它包括以下内容 −
- 基础库,包含协程子库
- 模块库
- 字符串操作
- 表格操作
- 数学库
- 文件输入和输出
- 操作系统工具
- 调试工具
基础库
我们在整个教程的各个主题下都使用了基本库。 下表提供了相关页面的链接,并列出了本 Lua 教程各个部分所涵盖的功能。
序号 | 库/方法 & 功能 |
---|---|
1 | Error Handling 包括错误处理函数,如断言、错误,如 Lua - 错误处理中所述。 |
2 | Memory Management 包括与垃圾回收相关的自动内存管理功能,如 Lua - 垃圾回收中所述。 |
3 | dofile ([filename]) 它打开文件并将文件的内容作为块执行。 如果没有传递参数,则此函数执行标准输入的内容。 错误将传播给调用者。 |
4 | _G 因此是保存全局环境的全局变量(即_G._G = _G)。 Lua 本身不使用这个变量。 |
5 | getfenv ([f]) 返回函数使用的当前环境。 f 可以是 Lua 函数或指定堆栈级别的函数的数字 − 级别 1 是调用 getfenv 的函数。 如果给定函数不是 Lua 函数,或者 f 为 0,则 getfenv 返回全局环境。 f 的默认值为 1。 |
6 | getmetatable (object) 如果对象没有元表,则返回 nil。 否则,如果对象的元表具有"__metatable"字段,则返回关联的值。 否则,返回给定对象的元表。 |
7 | ipairs (t) 此函数获取表的索引和值。 |
8 | load (func [, chunkname]) 使用函数 func 加载块以获取其片段。 对 func 的每次调用都必须返回一个与先前结果连接的字符串。 |
9 | loadfile ([filename])) 类似于加载,但如果没有给出文件名,则从文件文件名或标准输入中获取块。 |
10 | loadstring (string [, chunkname]) 类似于加载,但从给定的字符串中获取块。 |
11 | next (table [, index]) 允许程序遍历表的所有字段。 它的第一个参数是一个表,它的第二个参数是这个表中的一个索引。 next 返回表的下一个索引及其关联值。 |
12 | pairs (t) 暂停正在运行的协程。 传递给此方法的参数充当恢复函数的附加返回值。 |
13 | print (...) |
14 | rawequal (v1, v2) 检查 v1 是否等于 v2,而不调用任何元方法。 返回一个布尔值。 |
15 | rawget (table, index) 获取 table[index] 的实际值,而不调用任何元方法。 表必须是表; index 可以是任何值。 |
16 | rawset (table, index, value) 将 table[index] 的实际值设置为 value,而不调用任何元方法。 table 必须是一个表,索引任何不同于 nil 的值,并为任何 Lua 值赋值。 此函数返回表。 |
17 | select (index, ...) 如果 index 是一个数字,则返回参数编号 index 之后的所有参数。 否则,index 必须是字符串"#",并且 select 返回它接收到的额外参数的总数。 |
18 | setfenv (f, table) 设置给定函数要使用的环境。 f 可以是 Lua 函数或指定堆栈级别的函数的数字 − 级别 1 是调用 setfenv 的函数。 setfenv 返回给定的函数。 作为一种特殊情况,当 f 为 0 时,setfenv 会更改正在运行的线程的环境。 在这种情况下, setfenv 不返回任何值。 |
19 | setmetatable (table, metatable) 设置给定表的元表。 (不能从 Lua 中更改其他类型的元表,只能从 C 中更改。)如果 metatable 为 nil,则删除给定表的元表。 如果原始元表具有"__metatable"字段,则会引发错误。 此函数返回表。 |
20 | tonumber (e [, base]) 尝试将其参数转换为数字。 如果参数已经是数字或可转换为数字的字符串,则 tonumber 返回此数字; 否则,它返回 nil。 |
21 | tostring (e) 接收任何类型的参数并将其转换为合理格式的字符串。 要完全控制数字的转换方式,请使用 string.format。 |
22 | type (v) 返回其唯一参数的类型,编码为字符串。 此函数的可能结果是"nil"(字符串,而不是值 nil)、"number"、"string"、"boolean"、"table"、"function"、"thread"和"userdata"。 |
23 | unpack (list [, i [, j]]) 返回给定表中的元素。 |
24 | _VERSION 一个全局变量(不是函数),它包含一个包含当前解释器版本的字符串。 这个变量的当前内容是"Lua 5.1"。 |
25 | Coroutines 包括Lua - 协程中解释的协程操作函数。 |
模块库
模块库提供了在 Lua 中加载模块的基本功能。 它直接在全局环境中导出一个函数:require。 其他所有内容都以表格包的形式导出。 关于模块库的详细信息在前面的章节 Lua - 模块教程中进行了解释。
字符串操作
Lua 提供了一组丰富的字符串操作函数。 较早的 Lua - 字符串教程详细介绍了这一点。
表格操作
Lua 在几乎所有操作中都依赖于表。 较早的 Lua - 表格教程详细介绍了这一点。
文件输入输出
我们在编程中经常需要数据存储设施,这是由 Lua 中用于文件 I/O 的标准库函数提供的。 它在前面的 Lua - 文件 I/O 教程中讨论过。
调试工具
Lua 提供了一个调试库,它为我们创建自己的调试器提供了所有的原始函数。 它在前面的Lua - 调试教程中讨论过。