TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Using Stepping

Stepping commands allow users to walk through the code as it executes. This enables the programmer to read through the source code in execution order and limits the code to be read. Stepping commands are available to execute for a single line or instruction, stepping into or over called subprograms (Ada) or functions (C/C++).

Stepping allows you to control when the execution of a task will be stopped. For purposes of our discussion of stepping, a statement is a statement or declaration that has associated assembly code. Some declarations and statements are optimized away and thus have no associated assembly code.

The following step commands are available (in order from least detailed to most detailed).

Step Command
Function
Command Line
Step Over
Steps to the next statement in the same context. For example, steps over a procedure call to the next statement. For more information on Step Over, see Step Over.
o
Step Into
If the current statement is not a procedure call, steps to the next statement in the same context. If the current statement is a procedure call, steps to the first statement of the procedure. For more information on Step Into, see Step Into.
i
Step Statement
Steps one line of source code, stepping into called subprograms (Ada) or functions (C/C++). For more information on Step Statement, see Debug > Step > Step Statement.
s
Step Instruction
Steps one machine instruction. For more information on Step Instruction, see Debug > Step > Step Instruction.
si, ii
Step Over Instruction
Steps one machine instruction, stepping over called subprograms (Ada) or functions (C/C++). For more information on Step Over Instruction, see Debug > Step > Step Over Instruction.
oi
Step Into, Pass Signal
Steps into program, passing signal to program. For more information on Step Into, Pass Signal, see Step Into.
is
Step Over, Pass Signal
Steps to the next statement in the same context, passing signal to program. For more information on Step Over, Pass Signal, see Step Over.
os
Step, Pass Signal
Steps one line of source code, stepping into called subprograms (Ada) or functions (C/C++). Passes signal to program. For more information on Step, Pass Signal, see Step Into.
ss

Whenever the execution of a task stops and the Visit Source debugger option is selected, an editor window with the current language unit is displayed. The current statement is displayed in reverse video

Note: Stepping can also be accomplished directly in the Source window or through commands entered on the Command Line Paneat the Command Prompt. Additional information about stepping can be found in Using the Apex Debugger.

Exception Handling during Step Commands

If an exception occurs during a step command:

The normal completion of the step is determined as follows:


Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS