PREV UP NEXT ANA

16.5.121: DUMP

DUMP [, symbol ... ] [, /FIXED, /SYSTEM, /ZERO, /LOCAL, /CONTEXT, /FOLLOW, /FULL]

Shows info about the given symbol(s). By default, info on all named symbols except constants (predefined #NAME), system variables (predefined !NAME, and variables local to subroutines and functions is displayed.

/FIXED
display all constants (predefined #NAME).
/SYSTEM
display all system variables (predefined !NAME).
/ZERO
display all new zero-context variables.
/LOCAL
display all new local variables.
/CONTEXT
the argument (symbol) is the context number whose variables are to be displayed.
/FOLLOW
evaluate the arguments and dump the results. If /FOLLOW is not specified, then the arguments are not evaluated and the top-level structure is dumped.
/FULL
show all elements of multi-element symbols. By default, element lists are truncated.

The displayed information looks something like this:

 186          X array , LONG, # elem. = 3, (3)
 187          Y string, length: 4, value = 'name'

First comes the symbol number, then the name (if any), the data class, and then some class-dependent information which generally includes the size of the variable. In this case, the array x is of type LONG with 3 elements and a single dimension equal to 3. The string y has a length of 4 characters and value 'name'.

If any pointers (Pointers) are encountered that point at themselves, then these are silently rendered UNDEFINED instead.

Alias: D

See also: SHOW, DUMP_STACK, ATOMIZE

[2.13.185]