turtle.suck

From ComputerCraft Wiki
Jump to: navigation, search


Grid Redstone.png  Function turtle.suck
Moves one or more items from either the ground in front of the turtle, or, from an inventory-enabled block (such as a chest) in front of the turtle.
  • If an item is in the square directly in front of the turtle, it picks up one of those items.
  • If a chest is in the square directly in front of 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.
Syntax turtle.suck([number amount])
Returns boolean true if at least one item was moved into the turtle's inventory; false otherwise.
Part of ComputerCraft
API turtle

Examples

Grid paper.png  Example
Picks up some items from in front of the turtle.
Code
turtle.suck()


See also