最首要的,如果你是 Lua 新人,应该先熟悉Lua参考手册(英文)或菜鸟教程网的Lua教程。你可以在其中找到大部分Lua基础函数的解释,以及大量标准库函数。
OC致力于高度模拟通常用于与主机系统交互的标准库,也就是I/O库。其中有少许不同,你可以在这里查看:与标准库的差异。最值得注意的是,debug库基本上不可用,以及load
只接受文本源代码文件,不接受二进制或预编译的Lua程序(出于安全因素考虑)。
下列标准库在全局环境下可用,因此可以直接使用,无需预加载到你的脚本中。
print
不是库,但是经常被用于向stdout(标准输出)输出文本。print("hello world")
下列是为了方便而提供的非标准库的介绍。
请注意,所有非标准API在使用之前都需要 require
,非标准库即所有没有在Lua参考手册或标准库中列出的库。举例来说,你不可以只写一句 local rs = component.redstone
,你还需要先通过 require 调用此API,就像这样:
local component = require("component") local rs = component.redstone -- 你当然可以更改变量名称: local mycomp = require("component") local rs = mycomp.redstone
以下列出的 API 都是这样(甚至 sides 和 colors 也是如此)。
除了Lua提供的标准库外,OC还提供了一些额外的内置库。下面列出了这些库。请注意它们当中的一些可能无法使用,视你的配置(HTTP)或运行环境(电脑上无法调用机器人上的库)而定,但是它们仍然存在。
File*
API 带缓冲实现。