Difference between revisions of "Turtle.forward"

Revision as of 13:43, 30 November 2012

Function turtle.forward
Attempts to move the turtle forward.
Syntax	turtle.forward()
Returns	boolean whether the turtle succeeded in moving forward
Part of	ComputerCraft
API	turtle

Example
Tries to move the turtle forward and outputs whether it worked or not.
Code	if turtle.forward() then print ("Turtle moved forward.") else print ("Turtle didn't move forward.") end
Output	Turtle moved forward. or Turtle didn't move forward.

Example
Tries to move the turtle forward x number of times. X is specified by the user and if the turtle can't move forward it will break the block infront of it.
Code	Arg = (...) -- gets the parameters from the user if Arg ~= nil then Arg = tonumber (Arg) -- make it a number a = 1 while a <= Arg do if not turtle.forward() then turtle.dig() turtle.forward() end a = a + 1 end else print ("Missing parameter.") end
Output	Either the turtle moving the specified amount of times or missing parameter.

Example
Digs until the turtle can move forward.
Code	while not turtle.forward() do turtle.dig() end
Output	The turtle moves forward.

@@ Line 2: / Line 2: @@
 |name=turtle.forward
 |api=turtle
-|returns=[[boolean]] whether the turtle succeeded in moving forward
+|returns=[[boolean_(type)|boolean]] whether the turtle succeeded in moving forward
 |addon=ComputerCraft
 |desc=Attempts to move the turtle forward.