RAD Studio (Common)
ContentsIndex
PreviousUpNext
Add Source Breakpoint

RunAdd BreakpointSource Breakpoint 

Sets a breakpoint on a line in your source code or to change the properties of an existing breakpoint. The dialog box title can also be Source Breakpoint Properties or Address Breakpoint Properties, depending on how it is accessed.

Item 
Description 
Filename 
Specifies the source file for the source breakpoint. Enter the name of the source file for the breakpoint.  
Line number 
Sets or changes the line number for the breakpoint. Enter or change the line number for the breakpoint.  
Condition 
Specifies a conditional expression that is evaluated each time the breakpoint is encountered. Program execution stops when the expression evaluates to true. Enter a conditional expression to stop program execution.
Enter any valid language expression. All symbols in the expression must be accessible from the breakpoint's location. Functions are valid if they return a Boolean type.  
Pass count 
Stops program execution at a certain line number after a specified number of passes.
Enter the number of passes. The debugger increments the pass count each time the line containing the breakpoint is encountered. When the pass count equals the specified number, the debugger pauses program execution. For example, if the pass count is set to 3, you will see 0 of 3, 1 of 3, 2 of 3, then 3 of 3 in the pass count. Program execution stops at 3 of 3.
Because the debugger increments the count with each pass, you can use them to determine which iteration of a loop fails. Set the pass count to the maximum loop count and run your program. When the program fails, you can calculate the number of loop iterations by examining the number of passes that occurred.
When you use pass counts with conditions, program execution pauses the nth time that the conditional expression is true. the debugger decrements the pass count only when the conditional expression is true.  
Group 
Creates a breakpoint group, of which this breakpoint becomes a member. To use an existing group, select a group from the drop-down list. Using breakpoint groups is useful for performing a similar set of actions on all breakpoints within a group.  
Keep existing Breakpoint 
When checked, the breakpoint will not be modified, and a new breakpoint will be created with the changes made to the existing breakpoint.  
Advanced 
Expands the dialog box to include fields for associating actions with breakpoints.  
Break 
Halts execution; the traditional and default action of a breakpoint.  
Ignore subsequent exceptions 
Ignores all subsequent exceptions raised by the current process during the current debug session (the debugger will not stop on any exception). Use this with Handle subsequent exceptions as a pair. You can surround specific blocks of code with the Ignore/Handle pair to skip any exceptions which occur in that block of code.  
Handle subsequent exceptions  
Handles all subsequent exceptions raised by the current process during the current debug session (the debugger will stop on exceptions based on the current exception settings in ToolsOptionsDebugger OptionsLanguage Exceptions. This option does stop on all exceptions. Use it to turn on normal exception behavior after another breakpoint disabled normal behavior using the Ignore subsequent exceptions option.  
Log message 
Writes the specified message to the event log. Enter the message that you want to log.  
Eval expression  
Evaluates the specified expression and, because Log result is checked by default, writes the result of the evaluation to the event log. Uncheck Log result to evaluate without logging.  
Log result  
If text is entered in Eval expression, writes the result of the evaluation in the to the event log. If unchecked, the evaluation is not logged.  
Enable group 
Enables all breakpoints in the specified group. Select the group name.  
Disable group 
Disables all breakpoints in the specified group. Select the group name.  
Log Call Stack 
Displays all or part of the call stack in the Event Log window when a breakpoint is encountered.
Entire Stack displays all of the call stack.
Partial Stack displays only the number of frames specified in Number of frames.  
Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!