Difference between revisions of "Turtle.inspect"
From ComputerCraft Wiki
Magiczocker (Talk | contribs) m |
|||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 8: | Line 8: | ||
|desc=Returns the ID string and metadata of the block in front of the Turtle in a table format: <var>{ name = "modname:blockname", metadata = 0, state = {} }</var>.<br><br> | |desc=Returns the ID string and metadata of the block in front of the Turtle in a table format: <var>{ name = "modname:blockname", metadata = 0, state = {} }</var>.<br><br> | ||
| − | The "state" sub-table is only present in Minecraft 1.8+, and contains [ | + | The "state" sub-table is only present in Minecraft 1.8+, and contains [https://minecraft.gamepedia.com/Block_states block state] info for the block being inspected. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation). |
|examples={{Example | |examples={{Example | ||
|desc=If there is a block in front of the turtle, prints it's name and metadata. | |desc=If there is a block in front of the turtle, prints it's name and metadata. | ||
| Line 25: | Line 25: | ||
*[[turtle.inspectDown]] | *[[turtle.inspectDown]] | ||
*[[turtle.inspectUp]] | *[[turtle.inspectUp]] | ||
| + | [[Category:API Functions]] | ||
Latest revision as of 07:59, 4 August 2020
 Function turtle.inspect | |
| Returns the ID string and metadata of the block in front of the Turtle in a table format: { name = "modname:blockname", metadata = 0, state = {} }. The "state" sub-table is only present in Minecraft 1.8+, and contains block state info for the block being inspected. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation). | |
| Syntax | turtle.inspect() |
| Returns | boolean success, table data/string error message |
| Part of | ComputerCraft |
| API | turtle |
Examples
 Example | |
| If there is a block in front of the turtle, prints it's name and metadata. | |
| Code |
local success, data = turtle.inspect() if success then print("Block name: ", data.name) print("Block metadata: ", data.metadata) end |
Additional Notes
- Returns false when there is nothing (air) in front of the Turtle.
