Difference between revisions of "Turtle.dig"

Revision as of 02:07, 10 June 2016

Function turtle.dig
Attempts to dig the block in front of the turtle. If successful, suck() is automatically called, placing the item in turtle inventory in the selected slot if possible (block type matches and the slot is not a full stack yet), or in the next available slot. If a hoe is used to attempt to "dig" a dirt block, it will be tilled instead. Tilling is also possible if the space in front of the turtle is empty but dirt exists below that point.
Syntax	turtle.dig()
Returns	boolean whether the turtle succeeded in digging, string error message
Part of	ComputerCraft
API	turtle

Example
Digs the block in front of the turtle.
Code	print(turtle.dig())
Output	true if the turtle could dig the block, false if it could not or no block present.

Example
Digs the block in front of the turtle, but only if there is a block to dig (saves time).
Code	if turtle.detect() then turtle.dig() end
Output	the turtle digs if there is a block in front.

@@ Line 6: / Line 6: @@
 |returns={{Type|boolean}} whether the turtle succeeded in digging, {{type|string}} error message
 |addon=ComputerCraft
-|desc=Attempts to dig the block in front of the turtle.  If successful, [[Turtle.suck|suck()]] is automatically called, placing the item in turtle inventory in the selected slot if possible (block type matches and the slot is not a full stack yet), or in the next available slot.
+|desc=Attempts to dig the block in front of the turtle.  If successful, [[Turtle.suck|suck()]] is automatically called, placing the item in turtle inventory in the selected slot if possible (block type matches and the slot is not a full stack yet), or in the next available slot.<br><br>
+If a hoe is used to attempt to "dig" a dirt block, it will be tilled instead. Tilling is also possible if the space in front of the turtle is empty but dirt exists below that point.
 |examples=
 {{Example