Sides(方向) API
========
此“API”提供了一份全局表，以便你通过名称来引用相对/绝对方向，而无需使用它们的编号。底层的编号值与Minecraft内部的编号（即名为`ForgeDirection`的Enum）完全一致。此表提供了双向查询，因此你既可以将名称解析为编号，也可以通过编号反查适合人类阅读的名称。例如，`sides.top`对应数字值`1`，而`sides[1]`的值为字符串`top`。每个方向都有数个别名，因此不太可能意外写错。以下是基本值：

- 底面 (`bottom`), 数字: 0
- 顶面 (`top`), 数字: 1
- 背面 (`back`), 数字: 2
- 前面 (`front`), 数字: 3
- 右面 (`right`), 数字: 4
- 左面 (`left`), 数字: 5

默认情况下定义了如下别名：

- 底面: `down`, `negy`
- 顶面: `up`, `posy`
- 背面: `north`, `negz`
- 前面: `south`, `posz`, `forward`
- 右面: `west`, `negx`
- 左面: `east`, `posx`

方向在读写红石信号时很有用，例如：
```lua
local component = require("component")
local sides = require("sides")
local rs = component.redstone
rs.setOutput(sides.back, rs.getInput(sides.left))
```

目录
-----------
{{page>api:contents:zh&noheader&noeditbutton&nouser&nofooter}}