Michiyo: Clean up Markdown artifacts from DokuWiki migration

2026-08-24T20:27:03Z

Clean up Markdown artifacts from DokuWiki migration

← Older revision		Revision as of 20:27, 24 August 2026
Line 5:		Line 5:
	最首要的，如果你是 Lua 新人，应该先熟悉[http://www.lua.org/manual/5.3/manual.html Lua参考手册]（英文）或[https://www.runoob.com/lua/ 菜鸟教程网的Lua教程]。你可以在其中找到大部分Lua基础函数的解释，以及大量标准库函数。		最首要的，如果你是 Lua 新人，应该先熟悉[http://www.lua.org/manual/5.3/manual.html Lua参考手册]（英文）或[https://www.runoob.com/lua/ 菜鸟教程网的Lua教程]。你可以在其中找到大部分Lua基础函数的解释，以及大量标准库函数。

	OC致力于高度模拟通常用于与主机系统交互的标准库，也就是I/O库。其中有少许不同，你可以在这里查看：[[API/non-standard-lua-libs/zh\|与标准库的差异]]。最值得注意的是，debug库基本上不可用，以及`load` 只接受文本源代码文件，不接受二进制或预编译的Lua程序（出于安全因素考虑）。		OC致力于高度模拟通常用于与主机系统交互的标准库，也就是I/O库。其中有少许不同，你可以在这里查看：[[API/non-standard-lua-libs/zh\|与标准库的差异]]。最值得注意的是，debug库基本上不可用，以及<code>load</code> 只接受文本源代码文件，不接受二进制或预编译的Lua程序（出于安全因素考虑）。

	下列标准库在全局环境下可用，因此可以直接使用，无需预加载到你的脚本中。		下列标准库在全局环境下可用，因此可以直接使用，无需预加载到你的脚本中。
Line 15:		Line 15:
	* [[API/non-standard-lua-libs/zh#os(操作系统)\|os]]		* [[API/non-standard-lua-libs/zh#os(操作系统)\|os]]
	* [[API/non-standard-lua-libs/zh#package(包)\|package]]		* [[API/non-standard-lua-libs/zh#package(包)\|package]]
	* `print` 不是库，但是经常被用于向stdout(标准输出)输出文本。		* <code>print</code> 不是库，但是经常被用于向stdout(标准输出)输出文本。

	~~```~~lua print("hello world") ~~```~~		<syntaxhighlight lang="lua">
			print("hello world")
			</syntaxhighlight>

	* [[API/non-standard-lua-libs/zh#string(字符串)\|string]]		* [[API/non-standard-lua-libs/zh#string(字符串)\|string]]
Line 26:		Line 28:
	下列是为了便利而提供的非标准库的介绍。		下列是为了便利而提供的非标准库的介绍。

	请注意，所有非标准API在使用之前都需要`require `，非标准库即所有未在[http://www.lua.org/manual/5.3/manual.html Lua参考手册]或[[API/zh#标准库\|标准库]]中列出的库。例如，你不可以只写一句`local rs = component.redstone`，你还需要先通过`require`调用此API，就像这样：		请注意，所有非标准API在使用之前都需要<code>require </code>，非标准库即所有未在[http://www.lua.org/manual/5.3/manual.html Lua参考手册]或[[API/zh#标准库\|标准库]]中列出的库。例如，你不可以只写一句<code>local rs = component.redstone</code>，你还需要先通过<code>require</code>调用此API，就像这样：

	~~```~~lua local component = require("component") local rs = component.redstone		<syntaxhighlight lang="lua">
			local component = require("component") local rs = component.redstone

	-- 你当然可以修改变量名称： local mycomp = require("component") local rs = mycomp.redstone ~~```~~ 以下列出的 API 都是这样（甚至`sides`和`colors`也是如此）。		-- 你当然可以修改变量名称： local mycomp = require("component") local rs = mycomp.redstone
			</syntaxhighlight> 以下列出的 API 都是这样（甚至<code>sides</code>和<code>colors</code>也是如此）。

	除了Lua提供的标准库外，OC还提供了一些额外的内置库。下面列出了这些库。请注意它们当中的一些可能无法使用，视你的配置（HTTP）或运行环境（电脑上无法调用机器人上的库）而定，但是它们仍然存在。		除了Lua提供的标准库外，OC还提供了一些额外的内置库。下面列出了这些库。请注意它们当中的一些可能无法使用，视你的配置（HTTP）或运行环境（电脑上无法调用机器人上的库）而定，但是它们仍然存在。

	'' [[API/buffer/zh\|buffer(缓冲)]]：Lua `File''` API缓冲区的实现，用于封装流。 - [[API/colors/zh\|colors(颜色)]]：一份全局表，可用于以名称引用标准Minecraft颜色。 - [[API/component/zh\|component(组件)]]：查找与管理所有连接到电脑的组件。 - [[API/computer/zh\|computer(电脑)]]：查询运行Lua state的OC电脑信息，或与其交互。 - [[API/event/zh\|event(事件)]]：一个事件系统, 通常被其他库调用, 用于将处理函数注册到信号。 - [[API/UUID/zh\|uuid]]：创建8-4-4-4-12格式的长唯一标识字符串（uuid）。 - [[API/filesystem/zh\|filesystem(文件系统)]]：抽象化的与文件系统组件的交互。 - [[API/internet/zh\|internet(网络)]]：一个网卡功能的封装。 - [[API/keyboard/zh\|keyboard(键盘)]]：提供了一份按键编码表，以及跟踪按键按下状态。 - [[API/note/zh\|note(音符)]]：将音符在实际名称、MIDI编码和频率间转换。 - [[API/process/zh\|process(进程)]]：保持跟踪正在运行的程序与其运行环境。 - [[API/rc/zh\|rc(自动运行)]]：提供了自动运行程序和服务管理功能。 - [[API/robot/zh\|robot(机器人)]]：对机器人行为的抽象化访问。 - [[API/serialization/zh\|serialization(序列化)]]：用于将数值序列化，例如要通过网络发送数值时。 - [[API/shell/zh\|shell]]：追踪工作目录与执行程序。 - [[API/sides/zh\|sides(方向)]]：一份全局表，用于通过名称引用方向。 - [[API/term/zh\|term(终端)]]：提供了光标的概念，以及用于分别从键盘读取和向屏幕输出。 - [[API/text/zh\|text(文本)]]：提供文本编辑相关功能，例如将tab转为空格。 - [[API/thread/zh\|thread(线程)]]：提供自主且非阻塞的协作线程。 - [[API/transforms/zh\|transforms(转换)]]：提供有用且强大的表操作器。 - [[API/unicode/zh\|unicode]]：提供 string 库中某些功能的支持Unicode的实现。		'' [[API/buffer/zh\|buffer(缓冲)]]：Lua <code>File''</code> API缓冲区的实现，用于封装流。 - [[API/colors/zh\|colors(颜色)]]：一份全局表，可用于以名称引用标准Minecraft颜色。 - [[API/component/zh\|component(组件)]]：查找与管理所有连接到电脑的组件。 - [[API/computer/zh\|computer(电脑)]]：查询运行Lua state的OC电脑信息，或与其交互。 - [[API/event/zh\|event(事件)]]：一个事件系统, 通常被其他库调用, 用于将处理函数注册到信号。 - [[API/UUID/zh\|uuid]]：创建8-4-4-4-12格式的长唯一标识字符串（uuid）。 - [[API/filesystem/zh\|filesystem(文件系统)]]：抽象化的与文件系统组件的交互。 - [[API/internet/zh\|internet(网络)]]：一个网卡功能的封装。 - [[API/keyboard/zh\|keyboard(键盘)]]：提供了一份按键编码表，以及跟踪按键按下状态。 - [[API/note/zh\|note(音符)]]：将音符在实际名称、MIDI编码和频率间转换。 - [[API/process/zh\|process(进程)]]：保持跟踪正在运行的程序与其运行环境。 - [[API/rc/zh\|rc(自动运行)]]：提供了自动运行程序和服务管理功能。 - [[API/robot/zh\|robot(机器人)]]：对机器人行为的抽象化访问。 - [[API/serialization/zh\|serialization(序列化)]]：用于将数值序列化，例如要通过网络发送数值时。 - [[API/shell/zh\|shell]]：追踪工作目录与执行程序。 - [[API/sides/zh\|sides(方向)]]：一份全局表，用于通过名称引用方向。 - [[API/term/zh\|term(终端)]]：提供了光标的概念，以及用于分别从键盘读取和向屏幕输出。 - [[API/text/zh\|text(文本)]]：提供文本编辑相关功能，例如将tab转为空格。 - [[API/thread/zh\|thread(线程)]]：提供自主且非阻塞的协作线程。 - [[API/transforms/zh\|transforms(转换)]]：提供有用且强大的表操作器。 - [[API/unicode/zh\|unicode]]：提供 string 库中某些功能的支持Unicode的实现。

	== 目录 ==		== 目录 ==

	{{:API/contents/zh}}		{{:API/contents/zh}}

imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li

2026-08-24T08:08:27Z

Imported from legacy OpenComputers documentation at ocdoc.cil.li

New page

= API =

== 标准库 ==

最首要的，如果你是 Lua 新人，应该先熟悉[http://www.lua.org/manual/5.3/manual.html Lua参考手册]（英文）或[https://www.runoob.com/lua/ 菜鸟教程网的Lua教程]。你可以在其中找到大部分Lua基础函数的解释，以及大量标准库函数。

OC致力于高度模拟通常用于与主机系统交互的标准库，也就是I/O库。其中有少许不同，你可以在这里查看：[[API/non-standard-lua-libs/zh|与标准库的差异]]。最值得注意的是，debug库基本上不可用，以及`load` 只接受文本源代码文件，不接受二进制或预编译的Lua程序（出于安全因素考虑）。

下列标准库在全局环境下可用，因此可以直接使用，无需预加载到你的脚本中。

* [[API/non-standard-lua-libs/zh#coroutine(协程)|coroutine]]
* [[API/non-standard-lua-libs/zh#debug(调试)|debug]]
* [[API/non-standard-lua-libs/zh#io(输入输出)|io]]
* [[API/non-standard-lua-libs/zh#math(数学)|math]]
* [[API/non-standard-lua-libs/zh#os(操作系统)|os]]
* [[API/non-standard-lua-libs/zh#package(包)|package]]
* `print` 不是库，但是经常被用于向stdout(标准输出)输出文本。

```lua print("hello world") ```

* [[API/non-standard-lua-libs/zh#string(字符串)|string]]
* [[API/non-standard-lua-libs/zh#table(表)|table]]

== 自定义库 ==

下列是为了便利而提供的非标准库的介绍。

请注意，所有非标准API在使用之前都需要`require `，非标准库即所有未在[http://www.lua.org/manual/5.3/manual.html Lua参考手册]或[[API/zh#标准库|标准库]]中列出的库。例如，你不可以只写一句`local rs = component.redstone`，你还需要先通过`require`调用此API，就像这样：

```lua local component = require("component") local rs = component.redstone

-- 你当然可以修改变量名称： local mycomp = require("component") local rs = mycomp.redstone ``` 以下列出的 API 都是这样（甚至`sides`和`colors`也是如此）。

除了Lua提供的标准库外，OC还提供了一些额外的内置库。下面列出了这些库。请注意它们当中的一些可能无法使用，视你的配置（HTTP）或运行环境（电脑上无法调用机器人上的库）而定，但是它们仍然存在。

'' [[API/buffer/zh|buffer(缓冲)]]：Lua `File''` API缓冲区的实现，用于封装流。 - [[API/colors/zh|colors(颜色)]]：一份全局表，可用于以名称引用标准Minecraft颜色。 - [[API/component/zh|component(组件)]]：查找与管理所有连接到电脑的组件。 - [[API/computer/zh|computer(电脑)]]：查询运行Lua state的OC电脑信息，或与其交互。 - [[API/event/zh|event(事件)]]：一个事件系统, 通常被其他库调用, 用于将处理函数注册到信号。 - [[API/UUID/zh|uuid]]：创建8-4-4-4-12格式的长唯一标识字符串（uuid）。 - [[API/filesystem/zh|filesystem(文件系统)]]：抽象化的与文件系统组件的交互。 - [[API/internet/zh|internet(网络)]]：一个网卡功能的封装。 - [[API/keyboard/zh|keyboard(键盘)]]：提供了一份按键编码表，以及跟踪按键按下状态。 - [[API/note/zh|note(音符)]]：将音符在实际名称、MIDI编码和频率间转换。 - [[API/process/zh|process(进程)]]：保持跟踪正在运行的程序与其运行环境。 - [[API/rc/zh|rc(自动运行)]]：提供了自动运行程序和服务管理功能。 - [[API/robot/zh|robot(机器人)]]：对机器人行为的抽象化访问。 - [[API/serialization/zh|serialization(序列化)]]：用于将数值序列化，例如要通过网络发送数值时。 - [[API/shell/zh|shell]]：追踪工作目录与执行程序。 - [[API/sides/zh|sides(方向)]]：一份全局表，用于通过名称引用方向。 - [[API/term/zh|term(终端)]]：提供了光标的概念，以及用于分别从键盘读取和向屏幕输出。 - [[API/text/zh|text(文本)]]：提供文本编辑相关功能，例如将tab转为空格。 - [[API/thread/zh|thread(线程)]]：提供自主且非阻塞的协作线程。 - [[API/transforms/zh|transforms(转换)]]：提供有用且强大的表操作器。 - [[API/unicode/zh|unicode]]：提供 string 库中某些功能的支持Unicode的实现。

== 目录 ==

{{:API/contents/zh}}

API/zh - Revision history

Michiyo: Clean up Markdown artifacts from DokuWiki migration

imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li