Turtle.suckDown - Revision history

MisterSanderson: Adding "see also" and correcting the name of the function.

2015-04-21T21:04:20Z

Adding "see also" and correcting the name of the function.

MisterSanderson: Removing examples of other commands, keeping just the examples related to this command.

2015-04-21T20:50:55Z

Removing examples of other commands, keeping just the examples related to this command.

MisterSanderson: Creating the article about this command. The source of the text is turtle.suck.

2015-04-21T14:41:25Z

Creating the article about this command. The source of the text is turtle.suck.

New page

{{lowercase}}
{{Function
|name=turtle.suck
|args=[<nowiki></nowiki>{{type|number}} amount]
|returns={{type|boolean}} <var>true</var> if at least one item was moved into the turtle's inventory; <var>false</var> otherwise.
|api=turtle
|addon=ComputerCraft
|desc=
Moves one or more items from either the ground below the turtle, or, from an inventory-enabled block (such as a chest) below the turtle.
* If an item is in the square directly below the turtle, it picks up one of those items.
* If a chest is in the square directly below the turtle, it picks up the items from the first non-empty chest slot, moving from top left to bottom right. The items are moved into the currently selected turtle slot if there is room.
* If the currently selected turtle slot is filled up before all of the items are picked up, the remaining picked up items are put in the next available turtle slot.
* If the currently selected turtle slot is 16 and the next slot is required, it will loop around and try turtle slot 1, and so on.
* As of ComputerCraft 1.6, if an amount is specified, the turtle will attempt to pick up at most the specified number of items. Earlier builds always attempt to pick up a full slot.
|examples=
{{Example
|desc=Picks up some items from in front of the turtle.
|code='''turtle.suck()'''
}}
{{Example
|desc=Picks up some items from above the turtle.
|code='''turtle.suckUp()'''
}}
{{Example
|desc=Picks up some items from below the turtle.
|code='''turtle.suckDown()'''
}}
}}

[[Category:Lua_Core_Functions]]

@@ Line 1: / Line 1: @@
 {{lowercase}}
 {{Function
-|name=turtle.suck
+|name=turtle.suck.Down
 |args=[<nowiki></nowiki>{{type|number}} amount]
 |returns={{type|boolean}} <var>true</var> if at least one item was moved into the turtle's inventory; <var>false</var> otherwise.
@@ Line 19: / Line 19: @@
 }}
 }}
 [[Category:Lua_Core_Functions]]

@@ Line 14: / Line 14: @@
 * As of ComputerCraft 1.6, if an amount is specified, the turtle will attempt to pick up at most the specified number of items. Earlier builds always attempt to pick up a full slot.
 |examples=
 {{Example
 |desc=Picks up some items from below the turtle.