Difference between revisions of "Turtle.dig"
From ComputerCraft Wiki
(Corrected mapping from "Boolean" to "Boolean (type)") |
(Added second return value) |
||
Line 4: | Line 4: | ||
|args= | |args= | ||
|api=turtle | |api=turtle | ||
− | |returns= | + | |returns={{Type|boolean}} whether the turtle succeeded in digging, {{type|string}} error message |
|addon=ComputerCraft | |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. |
Revision as of 00:47, 19 December 2014
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. | |
Syntax | turtle.dig() |
Returns | boolean whether the turtle succeeded in digging, string error message |
Part of | ComputerCraft |
API | turtle |
Examples
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. |