Next: , Previous: , Up: Debugger Programmer’s Interface   [Contents][Index]


11.2 Debug-variables

Debug-variables represent the constant information about where the system stores argument and local variable values. The system uniquely identifies with an integer every instance of a variable with a particular name and package. To access a value, you must supply the frame along with the debug-variable since these are particular to a function, not every instance of a variable on the stack.

Function: debug-variable-name debug-variable

This function returns the name of the debug-variable. The name is the name of the symbol used as an identifier when writing the code.

Function: debug-variable-package debug-variable

This function returns the package name of the debug-variable. This is the package name of the symbol used as an identifier when writing the code.

Function: debug-variable-symbol debug-variable

This function returns the symbol from interning debug-variable-name in the package named by debug-variable-package.

Function: debug-variable-id debug-variable

This function returns the integer that makes debug-variable’s name and package name unique with respect to other debug-variable’s in the same function.

Function: debug-variable-validity debug-variable basic-code-location

This function returns three values reflecting the validity of debug-variable’s value at basic-code-location:

:valid

The value is known to be available.

:invalid

The value is known to be unavailable.

:unknown

The value’s availability is unknown.

Function: debug-variable-value debug-variable frame

This function returns the value stored for debug-variable in frame. The value may be invalid. This is SETF’able.

Function: debug-variable-valid-value debug-variable frame

This function returns the value stored for debug-variable in frame. If the value is not :valid, then this signals an invalid-value error.


Next: Frames, Previous: DI Exceptional Conditions, Up: Debugger Programmer’s Interface   [Contents][Index]