basic.debugger.variable.references Command/BASIC: Debugger

basic.debugger.variable.references

Command basic.debugger.variable.references Command/BASIC: Debugger
Applicable release versions: AP, R83, AP 6.0 FlashBASIC
Category BASIC: Debugger (38)
Description reference, and optionally alter the contents of, variables within the runtime code being executed.
Syntax {Flash.routine.name:}/variable
{Flash.routine.name:}/dim.array.variable
{Flash.routine.name:}/dim.array.variable(vector.number)
{Flash.routine.name:}/dim.array.variable(row.num,col.num)
/*
Options
Example
*/variable

This accesses a plain variable and displays its current value.

*/dim.array.variable

This displays each element of a dimensioned array. If a dimensioned array is 
referenced without a subscript, each element is displayed, one at a time. To 
exit this display without stepping through all the locations, hit the 
<break> key, or enter any non-null value. The non-null value will not 
replace any location displayed. The contents of the array can NOT be altered.

*/dim.array.variable(subscript)

This accesses a single-dimensioned array variable. With the subscript 
designated, only that element is displayed. This can also access a 
two-dimensional array and assumes the second subscript is 1.

*/dim.array.variable(row.num,col.num)

This accesses a specific location of a two-dimensional array.

*/* 

This displays the current assignment of every variable in the program. 
Typically, programs have a lot of variables. This function does NOT paginate, 
which results in having the variables fly by on the screen and not being very 
useful, unless the reader happens to be a speed reader. The <break> key 
will interrupt this "runaway" variable display and return to the 
debugger prompt character.

In each of the above cases (except the "/dim.array.variable" form), 
the operator is given the opportunity to change the requested value. If a 
<return> is entered at the "=" prompt, the symbol remains 
unchanged. Otherwise, any value entered is placed into the variable.
Purpose
Related basic.debugger.overview
basic.debugger.b
basic.debugger.k
basic.debugger.d
basic.debugger.t
basic.debugger.u
basic.debugger.