View source for Turtle.inspect

{{lowercase}}
{{Function
|name=turtle.inspect
|args=
|api=turtle
|returns={{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|addon=ComputerCraft
|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 [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
|desc=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
}}
|notes=
* Returns false when there is nothing (air) in front of the Turtle.
}}

==See also==
*[[turtle.inspectDown]]
*[[turtle.inspectUp]]
[[Category:API Functions]]