Create Breakpoint Dialog Box: Code Tab

Set a breakpoint that stops program execution at a specific source code location.

The debugger remembers the breakpoint and stops the program execution every time the debugger reaches the specified location.


Debug > Create Breakpoint...


Not available.


This field is mandatory.

Enter an expression into the Location field, or click Browse to browse a list of known symbols.

When the application reaches the expression, execution stops immediately. You can enter the following expressions into the Location field:

@LINElinenumber or "filename"\@LINE linenumber

A line number in the current source file or in the source file filename.

For example:

@LINE 74


"source/foo.cpp"\@LINE 74

functionnameor "filename"\functionname

A function in the current source file or in the source file filename. You can click the Browse button to browse for a symbol.

For example:





An address.

For example:



When you define a condition, the debugger evaluates this condition when execution stops at the specified location. If the result is FALSE (zero), the application continues executing. In this case, an optional skip count remains unchanged. The condition can be any Boolean expression in the current language. For example: choice==2


If you want the debugger to execute a command when the program execution stops at a breakpoint, enter this command into the Actions field. Run control actions (run, stop, next, step) are not allowed as breakpoint actions.


Select a symbol from the dropdown menu.


You can enter a positive integer as skip count number. The skip count defines the number of times a breakpoint hit is ignored. For example, a breakpoint with the skip number 2 would stop execution when encountered for the third time. First the debugger checks the condition, then the skip count number.


When you check Continue, the application continues executing after the debugger processes the Actions list. Otherwise, it stops.


If you want to set this breakpoint as a hardware breakpoint, check the Hard checkbox.

OK, Cancel

Click OK to create the breakpoint, or Cancel to cancel the operation.


If you want to set more than one breakpoint, click the Apply button to set a breakpoint and to leave the Set Breakpoint dialog box open.


The breakpoint should be at the beginning of the line. For example, a breakpoint at source code line 100 stops the program after line 99 executes.

For more complete information about compiler optimizations, see our Optimization Notice.