Difference between revisions of "Turtle.digDown"
From ComputerCraft Wiki
m (Moved to CAT:LuaCoreFunctions) |
(Add toolSide argument) |
||
| (6 intermediate revisions by 6 users not shown) | |||
| Line 2: | Line 2: | ||
{{Function | {{Function | ||
|name=turtle.digDown | |name=turtle.digDown | ||
| − | |args= | + | |args=[<nowiki/>{{type|string}} toolSide] |
|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 below the turtle. | + | |desc=Attempts to dig the block below 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> |
| + | |||
| + | When using a hoe, if the space beneath the turtle consists of air and the space beneath ''that'' is dirt, then the turtle may till that dirt by use of this function. | ||
|examples= | |examples= | ||
{{Example | {{Example | ||
| − | |desc= | + | |desc=Attempts to dig the block below the turtle. |
|code=print(turtle.digDown()) | |code=print(turtle.digDown()) | ||
|output=true if the turtle could dig the block, false if it could not or no block present. | |output=true if the turtle could dig the block, false if it could not or no block present. | ||
}} | }} | ||
}} | }} | ||
| + | |||
| + | ==See also== | ||
| + | *[[turtle.dig]] | ||
| + | *[[turtle.digUp]] | ||
[[Category:Lua_Core_Functions]] | [[Category:Lua_Core_Functions]] | ||
Latest revision as of 10:36, 24 October 2018
 Function turtle.digDown | |
| Attempts to dig the block below 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. When using a hoe, if the space beneath the turtle consists of air and the space beneath that is dirt, then the turtle may till that dirt by use of this function. | |
| Syntax | turtle.digDown([string toolSide]) |
| Returns | boolean whether the turtle succeeded in digging, string error message |
| Part of | ComputerCraft |
| API | turtle |
Examples
 Example | |
| Attempts to dig the block below the turtle. | |
| Code |
print(turtle.digDown()) |
| Output | true if the turtle could dig the block, false if it could not or no block present. |
