@@ -44,33 +44,33 @@ std.collectgarbage_opt.item.isrunning: |
4444
4545collectgarbage : |
4646 此函数是垃圾收集器的通用接口。它根据第一个参数 `opt` 执行不同的功能。
47-
47+
4848 ### opt
49-
49+
5050 - **"collect"**: 执行完整的垃圾收集循环。这是默认选项。
51-
51+
5252 - **"stop"**: 停止垃圾收集器的自动执行。收集器只会在显式调用之前运行,
5353 直到调用 restart。
54-
54+
5555 - **"restart"**: 重启垃圾收集器的自动执行。
56-
56+
5757 - **"count"**: 以 Kbytes 为单位返回 Lua 使用的总内存数。该值有小数部分,
5858 乘以 1024 可得到 Lua 使用的确切字节数(溢出除外)。
59-
59+
6060 - **"step"**: 执行垃圾收集步进。步进 "size" 由 `arg` 控制。如果值为 0,
6161 收集器将执行一个基本(不可分割)步进。对于非零值,收集器将执行
6262 相当于 Lua 分配了该数量内存(以 KBytes 为单位)的操作。
6363 如果步进完成了一个收集循环,则返回 **true**。
64-
64+
6565 - **"setpause"**: 将 `arg` 设置为收集器 *pause* (参见 §2.5)的新值。
6666 返回 *pause* 的前一个值。
67-
67+
6868 - **"incremental"**: 将收集器模式更改为增量模式。此选项后面可以跟三个数字:
6969 垃圾收集器暂停、步进倍率和步进大小。
70-
70+
7171 - **"generational"**: 将收集器模式更改为分代模式。此选项后面可以跟两个数字:
7272 垃圾收集器次要倍率和主要倍率。
73-
73+
7474 - **"isrunning"**: 返回一个布尔值,指示收集器是否正在运行(即未停止)。
7575
7676collectgarbage.param.opt : " "
@@ -135,23 +135,23 @@ load: |
135135 如果 `chunk` 是字符串,则代码块就是该字符串。如果 `chunk` 是函数,
136136 `load` 会重复调用它以获取代码块片段。每次调用 `chunk` 必须返回
137137 一个与先前结果连接的字符串。返回空字符串、**nil** 或无值表示代码块结束。
138-
138+
139139 如果没有语法错误,则将编译后的代码块作为函数返回;
140140 否则,返回 **nil** 加上错误消息。
141-
141+
142142 如果生成的函数有上值,则第一个上值设置为 `env` 的值(如果给定了该参数),
143143 或者设置为全局环境的值。其他上值初始化为 **nil**。(当你加载主代码块时,
144144 生成的函数将始终只有一个上值,即 _ENV 变量。但是,当你加载从函数创建的
145145 二进制代码块时(参见 string.dump),生成的函数可以有任意数量的上值。)
146146 所有上值都是新的,即它们不与任何其他函数共享。
147-
147+
148148 `chunkname` 用作错误消息和调试信息的代码块名称。如果省略,
149149 由于 `chunk` 是字符串,默认为 `chunk`,否则默认为 "=(load)"。
150-
150+
151151 字符串 `mode` 控制代码块是文本还是二进制(即预编译代码块)。
152152 它可以是字符串 "b"(仅二进制代码块)、"t"(仅文本代码块)
153153 或 "bt"(二进制和文本)。默认为 "bt"。
154-
154+
155155 Lua 不检查二进制代码块的一致性。恶意构造的二进制代码块可能会导致解释器崩溃。
156156
157157load.param.chunk : " "
@@ -209,10 +209,10 @@ next: |
209209 调用,或者在空表中使用 **nil** 调用时,`next` 返回 **nil**。
210210 如果省略第二个参数,则将其解释为 **nil**。特别是,你可以使用 `next(t)`
211211 来检查表是否为空。
212-
212+
213213 索引枚举的顺序未指定,*即使对于数字索引也是如此*。(要按数字顺序
214214 遍历表,请使用数字 **for**。)
215-
215+
216216 如果在遍历过程中将任何值赋给表中不存在的字段,则 `next` 的行为未定义。
217217 但是,你可以修改现有字段。特别是,你可以将现有字段设置为 nil。
218218
@@ -224,11 +224,11 @@ next.return.1: ""
224224
225225pairs : |
226226 如果 `t` 有元方法 `__pairs`,则以 `t` 为参数调用它并返回调用的前三个结果。
227-
227+
228228 否则,返回三个值:`next` 函数、表 `t` 和 **nil**,以便构造
229229 `for k,v in pairs(t) do *body* end`
230230 将遍历表 `t` 的所有键值对。
231-
231+
232232 关于在遍历期间修改表的注意事项,请参见函数 `next`。
233233
234234pairs.param.t : " "
@@ -293,25 +293,25 @@ require: |
293293 加载给定的模块。该函数首先在 'package.loaded' 表中查找 `modname`
294294 是否这就加载。如果是,则 `require` 返回存储在 `package.loaded[modname]`
295295 中的值。否则,它尝试为模块查找 *加载器*。
296-
296+
297297 为了查找加载器,`require` 由 `package.searchers` 序列引导。
298298 通过更改此序列,我们可以改变 `require` 查找模块的方式。
299299 以下解释基于 `package.searchers` 的默认配置。
300-
300+
301301 首先 `require` 查询 `package.preload[modname]`。如果它有值,
302302 该值(应该是一个函数)就是加载器。否则 `require` 使用存储在
303303 `package.path` 中的路径搜索 Lua 加载器。如果这也失败,它使用
304304 存储在 `package.cpath` 中的路径搜索 C 加载器。如果这也失败,
305305 它尝试 *一体化* 加载器(参见 `package.loaders`)。
306-
306+
307307 一旦找到加载器,`require` 就会使用两个参数调用加载器:`modname`
308308 和一个取决于它如何获取加载器的额外值。(如果加载器来自文件,
309309 这个额外值就是文件名。)如果加载器返回任何非 nil 值,require
310310 将返回的值赋值给 `package.loaded[modname]`。如果加载器没有返回
311311 非 nil 值并且没有给 `package.loaded[modname]` 赋值,则 `require`
312312 将 true 赋值给该条目。在任何情况下,require 返回
313313 `package.loaded[modname]` 的最终值。
314-
314+
315315 如果加载或运行模块时出现任何错误,或者找不到模块的任何加载器,
316316 则 `require` 引发错误。
317317
@@ -390,7 +390,7 @@ setmetatable: |
390390 为给定表设置元表。(要从 Lua 代码更改其他类型的元表,必须使用调试库。)
391391 如果 `metatable` 为 **nil**,则移除给定表的元表。如果原始元表
392392 具有 `"__metatable"` 字段,则引发错误。
393-
393+
394394 此函数返回 `table`。
395395
396396setmetatable.param.table : " "
@@ -403,10 +403,10 @@ tonumber: |
403403 当不带 `base` 调用时,`tonumber` 尝试将其参数转换为数字。
404404 如果参数已经是数字或可转换为数字的字符串,则 `tonumber` 返回该数字;
405405 否则,返回 **nil**。
406-
406+
407407 字符串的转换可以根据 Lua 的词法约定产生整数或浮点数。(字符串可以有
408408 前导和尾随空格以及符号。)
409-
409+
410410 当带 `base` 调用时,e 必须是一个字符串,被解释为该进制的整数。
411411 进制可以是 2 到 36 之间的任何整数(含)。在 10 以上的进制中,
412412 字母 'A'(大写或小写)表示 10,'B' 表示 11,依此类推,'Z' 表示 35。
@@ -419,7 +419,7 @@ tonumber.return.1: ""
419419tostring : |
420420 接收任何类型的值并将其转换为人类可读格式的字符串。(为了完全控制
421421 数字的转换方式,请使用 `string.format`)。
422-
422+
423423 如果 `v` 的元表具有 `__tostring` 字段,则 `tostring` 使用 `v`
424424 作为参数调用相应的值,并将调用的结果作为其结果。
425425
@@ -503,3 +503,4 @@ getfenv.param.f: |
503503
504504getfenv.return.1 : |
505505 与给定函数关联的环境表。
506+
0 commit comments