Reading additional return information

In the lua prompt, if you run turtle.suck() for example, it shows either true or shows false with a reason for the failure "No space for items" or "No items to suck".

Is there a way to distinguish between failure reasons with the running program?

Probably something like:

local success, failureReason = turtle.suck()

And then this:

local succeeded, reason = turtle.suck()
if succeeded then
  print("Succesfully collected item(s).")
else
  print("Failed for the following reason:")
  print(reason)
end

Lua has multiple assignment support.

That's the part that was missing. Thanks a bunch.