Locals Panel
The Locals Panel is a panel in the top-level Main Window.
The Locals Panel displays a table of the local variables (including
method arguments) in the current scope. The corresponding Java source code must be compiled
with debugging info turned on (-g) in order for local variables to
be displayed in the debugger.
table
Each row in the table represents a local variable. Each
local variable has the following attributes (which are the columns of the table).
[Shift] Click on a column header to sort the table in
[descending] ascending order according to that column.
- Name - the name of the local variable.
- Value - the current value of the local variable. Changed values and variables
that newly came into scope are displayed in red. If the value is
a non-null reference, then the corresponding object ID will be displayed in blue. If the value is
a null reference, then "null" will be displayed in blue.
Strings and characters are displayed in magenta.
- Type - the type of the local variable. Standard Java types are
displayed in blue.
To change a value of a primitive variable (boolean, byte, short, int, long, character, float, double),
double click on the corresponding value cell and enter the new value followed by hitting
the Enter key (or hit the Escape key to cancel the editing).
The new value string must validate in order for the change to be made.
A Tool Tip is displayable for each local variable row in the table.
For object references, the Tool Tip displays the object's fields in the
inheritance hierarchy. For array references, the Tool Tip displays the
beginning array elements. For string references, the Tool Tip displays the
beginning string characters. The number of lines displayed in a Tool Tip
is configurable in the Global Settings Dialog.
While the target JVM is running, an hour glass cursor will be displayed in the Locals Panel.
context menu
A popup Context Menu is displayed by right clicking on the table:
- Inspect... - displays the selected (in the table) non-null
object reference in the Object Panel
or the selected non-null array reference in the Array Panel
in the top-level Objects Window.
Strings are displayed in the String Panel
in the top-level String/To String Window.
The can also be accomplished by double clicking on a table row.
- To String... - invokes the toString() method on the selected
(in the table) non-null object reference and displays
the resulting string in the To String Panel
in the top-level String/To String Window.
- Hex - displays the selected local variable (which must
be of type short, int or long) in hexadecimal.
- Decimal - displays the selected local variable (which must be
of type short, int or long) in decimal.
- Add to Watch Panel 1 - adds the selected variable name to
Watch Panel 1.
- Add to Watch Panel 2 - adds the selected variable name to
Watch Panel 2.
- Unsort - returns the table data to its default order.
- Columns... - displays a dialog that allows the User to show or
hide individual table columns in the locals table.
- Help... - displays this Help.
©2001-2010. debugtools.com LLC. All rights reserved.