Add example to turtle.inspect

A pretty common but non-trivial API, so worth having something. Even if
not perfect.
This commit is contained in:
Jonathan Coates 2021-05-14 18:06:51 +01:00
parent d6e3c9a7fa
commit 4f0d311df7
1 changed files with 12 additions and 0 deletions

View File

@ -661,6 +661,18 @@ public final MethodResult equipRight()
* @return The turtle command result.
* @cc.treturn boolean Whether there is a block in front of the turtle.
* @cc.treturn table|string Information about the block in front, or a message explaining that there is no block.
* @cc.usage <pre>{@code
* local has_block, data = turtle.inspect()
* if has_block then
* print(textutils.serialize(data))
* -- {
* -- name = "minecraft:oak_log",
* -- state = { axis = "x" },
* -- tags = { ["minecraft:logs"] = true, ... },
* -- }
* else
* print("No block in front of the turtle")
* end}</pre>
*/
@LuaFunction
public final MethodResult inspect()