Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileDUMP [a$[TO b$]]

a$, b$: sexp

With the help of the DUMP command, the contents of variables can be displayed
during a program run; or labels, procedures, and functions listed.  In addition
the string expression a$ can accept the following:

Examples:

    DUMP

--> Returns all values of variables and the dimensioning of arrays.

    DUMP "a"

--> As above but only operates on variables or arrays which begin with 'a'.

    DUMP ":"
    DUMP ":b"

--> Lists all labels and specifies the Editor line number where each label is
    used. The variation (:b) lists only those labels which begin with 'b'.

    DUMP "@"
    DUMP "@b"

--> Lists all procedures and functions and specifies the Editor line number
    where each is found. The variation (@b) lists only those procedures and
    functions which begin with 'b'.

    proc_name @ 100     (procedure)
    func_name FN 200    (function returning a numerical value)
    func_name $ FN 300  (function returning a string)

Labels, procedures, and functions which are no longer defined, are specified
without Editor line numbers. If the program listing was saved with the SAVE,A
option and then newly reloaded, these undefined names no longer appear. However
labels, procedures, and function names which are still usable but not defined,
are displayed without Editor line numbers.

The Editor line number specified after the name can be jumped to in the Editor
by means of Control+G.

When the contents of a string is output, a maximum of 60 characters is
displayed. If the character string is longer than this, then the last character
displayed is '>'. If a control character, i.e. ASCII value < 32, is to be
displayed, this is replaced by a period.

The outputs mentioned above can also be directed to a file and, in this case,
the file name must be specified in b$.

If no extension is specified a default extension of '.DMP' is used.

Memo: See section 'The Modifier Keys'.
      Only the first two characters of parameter a$ are evaluated.
      Parameters other than the ones noted above are simply ignored.