12 drscheme:debug

drscheme:debug:profile-unit-frame-mixin : (class? . -> . class?)

argument extends/implements:  drscheme:frame:<%>   drscheme:unit:frame<%>

drscheme:debug:profile-interactions-text-mixin : (class? . -> . class?)

argument extends/implements:  drscheme:rep:text<%>

drscheme:debug:profile-definitions-text-mixin : (class? . -> . class?)

argument extends/implements:  drscheme:unit:definitions-text<%>   text%

(drscheme:debug:error-display-handler/stacktrace   msg             exn            [ stack])   →   any

msg : string?

exn : any/c

stack : (or/c false/c (listof srcloc?)) = #f

Displays the error message represented by the string, adding embellishments like those that appears in the DrScheme REPL, specifically a clickable icon for the stack trace (if the srcloc location is not empty), and a clickable icon for the source of the error (read & syntax errors show their source locations and otherwise the first place in the stack trace is shown).

If stack is false, then the stack trace embedded in the exn argument (if any) is used.

This should be called in the same eventspace and on the same thread as the error.

(drscheme:debug:make-debug-error-display-handler oedh)

→ (-> string? (or/c any/c exn?) any)

oedh : (-> string? (or/c any/c exn?) any)

This function implements an error-display-handler in terms of another error-display-handler.

This function is designed to work in conjunction with drscheme:debug:make-debug-eval-handler.

See also MzScheme’s error-display-handler parameter.

If the current-error-port is the definitions window in drscheme, this error handler inserts some debugging annotations, calls oedh, and then highlights the source location of the runtime error.

(drscheme:debug:make-debug-eval-handler odeh)

→ (any/c . -> . any/c)

odeh : (any/c . -> . any/c)

This function implements an eval-handler in terms of another eval-handler.

This function is designed to work in conjunction with drscheme:debug:make-debug-error-display-handler.

See also MzScheme’s eval-handler parameter.

The resulting eval-handler expands and annotates the input expression and then passes it to the input eval-handler, unless the input expression is already compiled, in which case it just hands it directly to the input eval-handler.

(drscheme:debug:hide-backtrace-window) → void?

Hides the backtrace window.

(drscheme:debug:profiling-enabled enabled?) → void?

enabled? : boolean?

(drscheme:debug:profiling-enabled) → boolean?

A parameter that controls if profiling information is recorded.

Defaults to #f.

Only applies if drscheme:debug:make-debug-eval-handler has been added to the eval handler.

(drscheme:debug:add-prefs-panel) → void?

Adds the profiling preferences panel.

(drscheme:debug:open-and-highlight-in-file debug-info) → void?

debug-info : srcloc?

This function opens a DrScheme to display debug-info. Only the src the position and the span fields of the srcloc are considered.

See also drscheme:debug:get-cm-key.

(drscheme:debug:show-backtrace-window   error-message             dis)   →   void?

error-message : string?

dis : (or/c exn? (listof srcloc?))

Shows the backtrace window you get when clicking on the bug in DrScheme’s REPL.

The error-message argument is the text of the error, dis is the debug information, extracted from the continuation mark in the exception record, using drscheme:debug:get-cm-key.

(drscheme:debug:get-cm-key) → any

Returns a key used with contination-mark-set->list. The contination mark set attached to an exception record for the user’s program may use this mark. If it does, each mark on the continuation is a list of the fields of a srcloc object.