ToC | DocOverview | CGDoc | RelNotes | Index | PermutedIndex
| Allegro CL

| ANSI Common Lisp 9 Conditions 9.2 Dictionary of Conditions
9.2.22 invoke-debugger | Function
  Syntax: invoke-debugger condition | Arguments and Values: condition - a condition object. Description: invoke-debugger attempts to enter the debugger with condition. If *debugger-hook* is not nil, it should be a function (or the name of a function) to be called prior to entry to the standard debugger. The function is called with *debugger-hook* bound to nil, and the function must accept two arguments: the condition and the value of *debugger-hook* prior to binding it to nil. If the function returns normally, the standard debugger is entered. The standard debugger never directly returns. Return can occur only by a non-local transfer of control, such as the use of a restart function. Examples:
       (ignore-errors ;Normally, this would suppress debugger entry
         (handler-bind ((error #'invoke-debugger)) ;But this forces debugger entry
           (error "Foo.")))
      Debug: Foo.
      To continue, type :CONTINUE followed by an option number:
       1: Return to Lisp Toplevel.
      Debug>
Side Effects: *debugger-hook* is bound to nil, program execution is discontinued, and the debugger is entered. Affected By: *debug-io* and *debugger-hook*. See Also: error, break Allegro CL Implementation Details: None.

© Franz Inc. All Rights Reserved - File last updated 2022-07-25