Differences

This shows you the differences between two versions of the page.

--- api:non-standard-lua-libs:zh [2023/11/28 10:18]
hfsr [位操作]
+++ api:non-standard-lua-libs:zh [2023/11/28 10:40]
hfsr [调试]
@@ Line 85: / Line 85: @@
 输入输出功能
 ---------------------------
-`io` 库中大部分[原函数](http://www.lua.org/manual/5.2/manual.html#6.8)都被重新实现了，它们工作在已挂载的文件系统组件上。标准输入通过 `io.read` （同 `term.read` 和 `io.stdin:read`）读取。 标准输出通过 `io.write` （同 `term.write`、`io.stdout:write` 和 `print`）写入。标准错误通过 `io.stderr:write` 写入。
+`io`库中的[原函数](http://www.lua.org/manual/5.2/manual.html#6.8)都被很大程度上重新实现了，它们工作在已挂载的文件系统组件上。标准输入通过`io.read`（以及`term.read`和`io.stdin:read`）读取。 标准输出通过`io.write`（以及`term.write`、`io.stdout:write`和`print`）写入。标准错误通过`io.stderr:write`写入。
-大多数情况下，它们应该与标准 Lua 实现在*功能上*等价。也许它们返回的错误信息与原版Lua 不同，但大多数情况下原版Lua使用的也是与平台相关的 C 异常库，因此将这些用于程序逻辑无论如何都不是一个好主意。
+大多数情况下，它们应该与标准Lua实现在**功能上**等价。也许它们返回的错误信息与原版Lua 不同，但大多数情况下原版Lua使用的也是基于平台的C异常库，因此将这些用于程序逻辑无论如何都不是一个好主意。
-- `io.open(path, mode)` *不*支持 `+` 模式，即只支持 `r`、`w`、`a` 和 `rb` （允许使用`wb` 和 `ab` 模式，但是二进制模式对写入来说没有意义）。 注意， `io.open()` 返回 [[api:buffer:zh#实例方法|带缓冲IO流]]，有比较智能的 api，如 `read("*a")` 可以读取整个文件，或者 `io.read("*l")` 可以读取一行。注意，带缓冲IO流（由 `io.open`返回的）可以是二进制模式或文本模式，而原始流（由 `filesystem.open`返回的）是且只能是二进制模式。 流是二进制模式还是文本模式只会影响到 `read`。
+- `io.open(path, mode)`**不支持**`+`模式，即只支持`r`、`w`、`a`和`rb`（允许使用`wb` 和 `ab` 模式，但是二进制模式对写入来说没有意义）。
+注意，`io.open()`返回[[api:buffer:zh#实例方法|带缓冲IO流]]，有比较智能的API，如`read("*a")` 可以读取整个文件，或者`io.read("*l")`可以读取一行。
+还需注意，带缓冲IO流（由 `io.open`返回的）可以是二进制模式或文本模式，而原始流（由 `filesystem.open`返回的）是且只能是二进制模式。 流是二进制模式还是文本模式只会影响到 `read`。
   `path` 是你想打开的文件的相对路径或绝对路径。
@@ Line 95: / Line 97: @@
   `mode` 可以是 `nil` 或一个字符串， `nil` 默认为“r”。
   - **二进制模式**
+  `io.open(path, "rb")`或`filesystem.open(path)`返回的流是二进制格式。`filesystem.open(path, "rb")`的写法也可以，但从`filesystem.open`返回的流**永远**都是二进制模式。
-  `io.open(path, "rb")` 或 `filesystem.open(path)` 返回的流是二进制格式。 `filesystem.open(path, "rb")` 也可以，但从 `filesystem.open` 返回的流**永远**都是二进制模式。 `stream:read(1)` 在二进制模式下读取一个字节。通过 `buffered_stream:read("*n")` 读取一个数值会把数据读成单字节的字符。（缓冲流从 `io.open` 返回，并支持从流中解释数值）
+  二进制模式下的`stream:read(1)`读取一个字节。
+  通过`buffered_stream:read("*n")`读取一个数字值会将数据以单字节字符的形式读取。（缓冲流从 `io.open` 返回，并支持从流中解释数值）
-  - **文本模式**
+\\
+  - **文本模式**
-  只有从 `io.open` 返回的，模式中没有使用 "b" 的流才是文本模式。例如 `io.open(path)` 和 `io.open(path, "r")`。`filesystem.open` 返回的任何句柄都不是文本模式下的流。文本模式下的 `stream:read(1)` 是考虑Unicode的单个字符。它可能是单字节的，或者甚至有3个字节——这取决于文本。 通过 `buffered_stream:read("*n")` 将一个数值读取成 unicode 字符。（带缓冲IO流是由 `io,open` 返回的，支持从流中解释数值）
+  只有从`io.open`返回的，模式中没有使用"b"的流才是文本模式。例如`io.open(path)`和`io.open(path, "r")`。`filesystem.open`返回的任何句柄都不是文本模式下的流。
-  * `io.open(path, "r")` 相当于 `io.open(path)`，它以文本只读模式打开一个文件。
+  文本模式下的`stream:read(1)`读取单个Unicode字符。它可能是单字节的，或者甚至有3个字节，取决于文本。
-  * `io.open(path, "rb")` 以二进制只读模式打开一个文件。
+  通过`buffered_stream:read("*n")`读取一个数字值会将数据以unicode字符的形式进行读取。（带缓冲IO流是由 `io,open` 返回的，支持从流中解释数值）
-  * `io.open(path, "w")` 删除文件的所有内容，以写模式打开文件。流是二进制模式还是文本模式并不影响写入。因此“w”在功能上等价于“wb”。
+ \\
-  * `io.open(path, "a")` 以写模式打开一个文件并将文件句柄位置放在文件的末尾，这意味着下一次写入会追加到文件末尾。
+  * `io.open(path, "r")` 相当于 `io.open(path)`，它以文本只读模式打开一个文件。
-- `io.stdin` 从模拟的 stdin 中读取数据，它默认为 OpenOS shell 中的用户输入。注意 `io.read()` 是 `io.stdin:read()` 的简称，它们会被解析为完全相同的操作。
+\\
+  * `io.open(path, "rb")` 以二进制只读模式打开一个文件。
+\\
+  * `io.open(path, "w")` 删除文件的所有内容，以写模式打开文件。流是二进制模式还是文本模式并不影响写入。因此“w”在功能上等价于“wb”。
+\\
+  * `io.open(path, "a")` 以写模式打开一个文件并将文件句柄位置放在文件的末尾，这意味着下一次写入会追加到文件末尾。
+\\
+- `io.stdin`从模拟的stdin中读取数据，它默认为OpenOS shell中的用户输入。注意`io.read()`是`io.stdin:read()`的简写，它们会被解析为完全相同的操作。
 ```lua
-io.stdin:read() -- 从 std in 中读取
+io.stdin:read() -- 从stdin中读取
-io.read() -- 也是从 std in 中读取
+io.read() -- 也是从stdin中读取
-term.read() -- 也是从 std in 中读取
+term.read() -- 也是从stdin中读取
 ```
-- `io.stdout` 将数据写到模拟的 stdout，默认在 gpu 上渲染。注意 `io.write()` 是 `io.stdout:write()` 的简称，它们会被解析为完全相同的操作。
+- `io.stdout`将数据写到模拟的stdout，默认为在GPU上渲染。注意`io.write()`是`io.stdout:write()`的简称，它们会被解析为完全相同的操作。
 ```lua
-io.stdout:write("写入 stdout")
+io.stdout:write("写入stdout")
-io.write("也是写入 stdout")
+io.write("也是写入stdout")
-term.write("也是写入 stdout，但如果字符串超过屏幕分辨率允许的宽度，就会自动换行，就像这样--------------------------------------------------------------------------------------------------------------------------------#")
+term.write("也是写入stdout，但如果字符串超过屏幕分辨率允许的宽度，就会自动换行")
 ```
-- `io.stderr` 将数据写到模拟的 stderr，默认在 gpu 上渲染，但如果主 GPU 和屏幕支持的话，会尝试用红色渲染。没有像 stdin 和 stdout 那样的使用 stderr 的快捷方式。
+- `io.stderr`将数据写到模拟的stderr，默认在GPU上渲染，但如果首选GPU和屏幕支持的话，会尝试用红色渲染。没有像stdin和stdout那样的使用stderr的快捷方式。
 ```lua
-io.stderr:write("向 stderr 写入错误信息")
+io.stderr:write("向stderr写入错误信息")
 ```
 操作系统功能
 ---------------------------
-`os` 库内的[原函数](http://www.lua.org/manual/5.2/manual.html#6.9)已经被部分重新实现。
+`os`库内的[原函数](http://www.lua.org/manual/5.2/manual.html#6.9)已经被部分重新实现。
-- `os.clock` 被重新实现为返回一个近似的 CPU 时间，也就是计算机在一个执行器线程中实际运行的时间。这与计算机运行时间*不*一样，获取此时间请参见[[api:computer:zh|computer.uptime]]。
+- `os.clock`被重新实现为返回近似CPU时间，也就是计算机在一个执行器线程中实际运行的时间。这与计算机运行时间**不一样**，获取此时间请参见[[api:computer:zh|computer.uptime]]。
-- `os.date` 被重新实现为游戏中的时间，并支持大多数格式。
+\\
-- `os.execute` 被重新实现，相当于从已挂载的文件系统中通过 `shell.execute` 启动程序。传入的字符串相当于在 shell 内输入的命令。
+- `os.date`被重新实现为使用游戏内时间，并支持大多数格式。
-- `os.exit` 抛出一个错误并试图终止当前的 coroutine。
+\\
-- `os.setenv` 添加 Lua shell 的环境变量。
+- `os.execute`被重新实现，相当于从已挂载的文件系统中通过`shell.execute`启动程序。传入的字符串相当于在 shell 内输入的命令。
-- `os.remove` 是 `filesystem.remove` 的别名。
+\\
-- `os.rename` 是 `filesystem.rename` 的别名。
+- `os.exit`抛出一个错误并试图终止当前的协程。
-- `os.setlocale` *不*可用。
+\\
+- `os.setenv`添加Lua shell的环境变量。
+\\
+- `os.remove`是`filesystem.remove`的别名。
+\\
+- `os.rename`是`filesystem.rename`的别名。
+\\
+- `os.setlocale`**不可用**。
+\\
 - `os.time` 被重新实现为返回自世界创建以来的游戏时间。
-  注意这个时间是以“游戏内的秒”为单位的。要获得世界创建起的时间刻（tick），需要将其乘以 `1000/60/60` （因为一天有24000个时间刻） 然后减去 6000。这个 6000 的偏移量不是随便设计的，它可以确保早上 6 点确实是那个时候。Minecraft莫名其妙地认为早上六点是零，可能是因为那是一个新游戏开始的时间……
+  注意这个时间是以“游戏内秒”为单位的。要获得世界创建起的tick数，需要将其乘以 `1000/60/60`（因为一天有24000个时间刻）然后减去6000。这个6000的偏移量不是随便设置的，它可以确保早上6点确实是早上6点。Minecraft莫名其妙地认为早上六点是零，可能是因为那是新游戏开始的时间……
+\\
 - `os.tmpname` 已被重新实现，可以创建一个未使用的名字挂载到 `/tmp` 下。
 额外增加了一个函数：
-- `os.sleep(seconds: number)` 允许在指定的时间内暂停脚本。`os.sleep` 消耗事件，但注册的处理函数和线程在休眠时仍会接收事件。换句话说，在睡眠状态下，信号仍然会被处理函数处理，也就是说你无法在睡眠结束后拉取睡眠期间堆积的信号，因为没有信号会留在队列中（或者说至少不是全部信号）。
+- `os.sleep(seconds: number)`允许暂停脚本指定时间长度。`os.sleep`会消耗事件，但注册的处理函数和线程在休眠时仍会接收事件。换句话说，在睡眠状态下，信号仍然会被处理函数处理，也就是说你无法在睡眠结束后拉取睡眠期间堆积的信号，因为没有信号会留在队列中（或者说至少不是全部信号）。
-[[api:computer:zh|computer(电脑) API]] 提供了一些类似这个类别的函数。
+此类别的一些新函数可以在[[api:computer:zh|computer(电脑) API]]中找到。
 调试
 -----
-只实现了 `debug.traceback` 和 `debug.getinfo` (1.5.9 起)，后者仅限被动信息。
+只实现了`debug.traceback`和`debug.getinfo`（1.5.9起），仅限被动信息。
 目录
 -----------
 {{page>api:contents:zh&noheader&noeditbutton&nouser&nofooter}}