Skip to main content

IAR Embedded Workbench for Arm 9.70.x

Watch window

In this section:

What do you want to do?

YellowStripe.png

The Watch window is available from the View menu.

WatchWin_02_Mym80.png

Use this window to monitor the values of C-SPY expressions or variables. You can open up to four instances of this window, where you can view, add, modify, and remove expressions. Tree structures of arrays, structs, and unions are expandable, which means that you can study each item of these.

Every time execution in C-SPY stops, the values in the Watch window are recalculated. Values that have changed since the last stop are highlighted in red.

Warning

Be aware that expanding very large arrays can cause an out-of-memory crash. To avoid this, expansion is automatically performed in steps of 5000 elements.

Requirements

Can be used with all C-SPY debugger drivers and debug probes.

Display area

This area contains these columns:

Expression

The name of the variable.

A name in square brackets, for example [fieldname], is either the name of a base class for a struct/class object or—if shown in gray and italic)—a pointer to the full object when of a class type derived from the original class.

Value

The value of the variable. Values that have changed are highlighted in red.

Dragging text or a variable from another window and dropping it on the Value column will assign a new value to the variable in that row.

This column is editable.

Location

The location in memory where this variable is stored.

Type

The data type of the variable.

Context menu

This context menu is available:

WatchWinPopUp_Hom73_8.png

Note

The contents of this menu are dynamic and depend on which features that your combination of software and hardware supports. However, the list of menu commands below is complete and covers all possible commands.

These commands are available:

Remove

Removes the selected expression from the window.

Remove All

Removes all expressions listed in the window.

Default Format, Binary Format, Octal Format, Decimal Format, Hexadecimal Format, Char Format

Changes the display format of expressions. The display format setting affects different types of expressions in different ways. Your selection of display format is saved between debug sessions. These commands are available if a selected line in the window contains a variable.

The display format setting affects different types of expressions in these ways:

Variables

The display setting affects only the selected variable, not other variables.

Array elements

The display setting affects the complete array, that is, the same display format is used for each array element.

Structure fields

All elements with the same definition—the same field name and C declaration type—are affected by the display setting.

Show As

Displays a submenu that provides commands for changing the default type interpretation of variables. The commands on this submenu are mainly useful for assembler variables—data at assembler labels—because these are, by default, displayed as integers.For more information, see Viewing assembler variables.

Save to File

Saves content to a file in a tab-separated format.

Right Align ‘Value’ Column

Right-aligns the contents of the Value column.

Options

Displays the IDE Options dialog box where you can set various options for C-SPY windows.