最基本也是最首要的,如果你是 Lua 新人,你应该熟悉 Lua 参考手册(英文)。你会在这里找到大部分基本 Lua 功能和例子,以及大量标准库功能。
(译者注:中文读者可参见菜鸟教程的 Lua 教程。)
OC 努力在很大程度上模拟平时与主机系统交互的标准库,也就是 I/O 库。其中有少许不同,你可以在这里查看:与标准库的差异。最值得注意的是,debug 库基本上不可用,以及load
只接受文本源代码文件,不接受二进制或预编译的 Lua 程序(出于安全因素考虑)。
下列标准库在全局环境下可用,因此可以直接使用,无需预加载到你的脚本中。
print
不是库,但是经常被用作向stdout(标准输出)输出文本的基本方法。print("hello world")
下列是为了方便而提供的非标准库。
请注意,在使用所有非标准库之前,你需要 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 缓冲区实现。