4.5.1 Displaying the Values of Variables
To display the current value of a variable, use the EXAMINE
command as follows:
DBG> EXAMINE variable_name
The debugger recognizes the compiler-generated data type
of the specified variable and retrieves and formats the data
accordingly. The following examples show some uses of the
EXAMINE command:
Examine a string variable:
DBG> EXAMINE EMPLOYEE_NAME
PAYROLL\EMPLOYEE_NAME: "Peter C. Lombardi"
DBG>
Examine three integer variables:
DBG> EXAMINE WIDTH, LENGTH, AREA
SIZE\WIDTH: 4
SIZE\LENGTH: 7
SIZE\AREA: 28
DBG>
Examine a two-dimensional array of integers (three per
dimension):
DBG> EXAMINE INTEGER_ARRAY
PROG2\INTEGER_ARRAY
(0,0): 27
(0,1): 31
(0,2): 12
(1,0): 15
(1,1): 22
(1,2): 18
DBG>
Examine element 4 of a one-dimensional string array:
DBG> EXAMINE CHAR_ARRAY(4)
PROG2\CHAR_ARRAY(4): 'm'
DBG>
Note that the EXAMINE command can be used with any
kind of address expression (not just a variable name) to
display the contents of a program location. The debugger as-
sociates certain default data types with untyped locations.
You can override the defaults for typed and untyped locations
if you want the data to be interpreted and displayed in some
other data format. The debugger supports the data types and
operators of BASIC including RECORDs and RFAs.
See Section 4.5.3 for an explanation of how the EXAMINE
and the EVALUATE commands differ.