最基本也是最首要的,如果你是 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 带缓冲实现。