Create Breakpoint Dialog Box: Data Tab

Set a data breakpoint that stops program execution when a specific memory area is accessed.

The debugger remembers the data breakpoint and stops the program execution every time the specific memory area is accessed. Data breakpoints are also referred to as watchpoints.

Menu

Debug > Create Breakpoint...

Toolbar

Not available.

Location

Enter an expression into the Location field. When the application reaches the expression, execution stops immediately. You can specify the following expressions in the Location field:

varname or "filename"\varname

A variable visible in the current scope or a global variable.

For example: foo_array

or

"src/foo.cpp"\foo_array

address

An address.

For example: 0x000080f8

Condition

When you define a condition, the debugger evaluates this condition after execution stops at the specified location. If the result is FALSE (zero), the program continues executing. In this case, an optional skip count does not change. The condition can be any Boolean expression in the current programming 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.

Length

Specifies the size of the monitored memory region in bytes. This overrides the default which is the size of the variable referred to by Location. For example:

2 for a memory region of 2 bytes (=16 bits).

Access

Access specifies on which type of access to stop execution. The default value is Read & Write.

Browse

Click Browse to open the Symbol Browser displaying a list of the known symbols.

Continue

When you check Continue, the target program continues executing after processing the Actions list. Otherwise, it stops.

OK Cancel

Click OK to create the data 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.

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