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.

Menu

Debug > Create Breakpoint...

Toolbar

Not available.

Location

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

or

"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:

main

or

"src/foo.cpp"\main

address

An address.

For example:

0x0000810C

Condition

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

Actions

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.

Symbol

Select a symbol from the dropdown menu.

Skip

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.

Continue

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

Hard

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.

Apply

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.

Note

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.