GET_INFO (DEBUG)

This form can take either two or three parameters. The first parameter is always the keyword DEBUG. The second parameter is any of the words in the following list. The third parameter (in the case of the word "examine") is the name of a specific variable. Any of the following can be used as the second parameter:

Parameter 2 Return

"breakpoint" Returns a string which is the name of the first breakpoint in the currently running procedure. This establishes a reference for the "next" and "previous" breakpoint calls.

"examine" Displays the contents of the variable passed as parameter 3.

"line_number" Returns the line number of the current breakpoint within current procedure.

"local" Returns the first local variable in current procedure. This establishes a point of reference for the "next" and "previous" variable calls.

"next" Returns are based on the preceding call. A breakpoint is returned if preceded by GET_INFO (DEBUG, "breakpoint"). A local variable is returned if preceded by GET_INFO (DEBUG, "local"). A parameter is returned if preceded by GET_INFO (DEBUG, "parameter"). Note that one of the above must be used before GET_INFO (DEBUG, "next") can return meaningful information.

"parameter" Returns the first local parameter in the currently running procedure. This establishes a point of reference for the "next" and "previous" parameter calls.

"previous" Returns values in the same manner as “next” above.

"procedure" Returns the string name of the procedure that contains the breakpoint.

Syntax:

value := GET_INFO (DEBUG, request )

Example:

The following creates the string FRED, stored in variable s, at the current edit position.

s := "FRED";

COPY_TEXT (GET_INFO (DEBUG, "examine", s));