1.2.3 Resuming Execution (step, next, finish, return, continue, jump)

``Continuing'' means resuming program execution until the program completes normally. In contrast, ``stepping'' means executing just one statement of the program. When continuing or stepping, the program may stop even sooner, due to a breakpoint or an exception.

s(tep) [count]

Execute the current line, stop at the first possible occasion (either in a function that is called or on the next line in the current function).

n(ext) [count]

Continue execution until the next line in the current function is reached or the function returns. The difference between "next" and "step" is that "step" stops inside a called function, while "next" executes called functions at (nearly) full speed, stopping only at the next line in the current function.

finish

Continue execution until the current function returns. that point the "retval" command can be used to show the return value. The short command name is rv.

See also 1.2.4 and 1.2.3.

return

Make selected stack frame return to its caller. Control remains in the debugger, but when you continue execution will resume at the return statement found inside the subroutine or method. At present we are only able to perform this if we are in a subroutine that has a return statement in it. See also 1.2.4 and 1.2.3

c(ontinue)

Continue execution, stop only when a breakpoint is encountered.

jump lineno

Set the next line that will be executed. available only in the bottom-most frame. This lets you jump back and execute code again, or jump forward to skip code that you don't want to run.

Not all jumps are allowed--for instance it is not possible to jump into the middle of a for loop or out of a finally clause.

See About this document... for information on suggesting changes.