# The Locals Window

## Overview

The Locals Window displays all local variables in scope. It may be used to visualize local variables. Local variables need to be collected before they can be viewed. See Adding an Action in the Tracepoint Dialog for more information.

Locals Window topics:

- Variable Menu
  - Format
- Locals Display
  - Dereferencing Pointers
  - Viewing a Structure or Class
  - Locals Pop-up Menu

### Variable Menu

The Variable Menu gives on-screen access to the funtions of the Locals Window. To use any of these functions, first use the left mouse button to select a variable from the display. Then select:

Format
  Change the display format of the variable

### Locals Display The Locals Window Display consists of a scrolled listbox which contains all local variables, one per line. Locals which were not collected at the current tracepoint will display a memory-access error. To use any of the functions of the Locals Window, use the left mouse button to select any element from the Display.

Pointers, structures, and classes appear in the display with small exapansion box before their names. To dereference pointers or view the members of classes or structures, click the closed expansion box (which appears as a small plus sign, "+") to "expand" the listing. The expansion box changes to a minus sign, "-", indicating that the display is now open. Pointers, structures and classes may be expanded recursively to allow multiple pointer dereferences and embedded structure viewing.

The Locals Display updates as the trace buffer is navigated, highlighting in blue those variables whose values have changed.

The Locals Window will, by default, display all pointers in hexadecimal and all other variables in decimal. To change the default display of variables, use the "set output-radix" command in the console window. (Type "help set output-radix" in the console window for help. To make this change permanent, it must be added to the user's init file -- .gdbinit under unix and gdb.ini under Windows.) To change the display format for a variable, select the Format option from either the Variable Menu or the Locals Pop-up Menu.

#### Locals Pop-up Menu

The Locals Pop-up Menu provides quick access to the functions of the Locals Window. To use the Locals Pop-up Menu, first select a variable from the Display (by clicking the left mouse button on it) and click the right mouse button, choosing from the pop-up:

Format
  Change the display format of the variable. The variable may be displayed as:
  Hex
    hexadecimal (base 16)
  Decimal
    decimal (base 10)
  Binary
    binary (base 2)
  Octal
    octal (base 8)