BASIC.DUMP Statement

Writes a SOFT dump item to the BASIC-DUMPS file.

Syntax

BASIC.DUMP {message} {"F"|"P"}

Syntax elements

messageAn optional string that is included in the dump item.

FAlways dump variables.

PNever dump variables.

Comment

If neither F nor P are specified then whether or not the SOFT dump item includes program variables and their contents depends on the current setting of the DUMP.BASIC.VARS custom environment option.

Example

IF X = 1 THEN
    GOSUB DOIT
END ELSE
    BASIC.DUMP “Expected ‘X’ to be 1 not ‘“:X:”’”
END

The above program fragment generates a SOFT dump item with a message containing the unexpected value of “X”.

See also

DataBasic application dump