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 - 调试教程中讨论过。