A.37 library(prolog_debug): User level debugging tools
AllApplicationManualNameSummaryHelp

  • Documentation
    • Reference manual
      • The SWI-Prolog library
        • library(prolog_debug): User level debugging tools
          • debug_control_hook/1
          • spy/1
          • nospy/1
          • nospyall/0
          • debugging/0
          • trap/1
          • notrap/1
          • exception_hook/4
    • Packages
Availability::- use_module(library(prolog_debug)).(can be autoloaded)
Source[det]trap(+Formal)
[det]notrap(+Formal)
Install a trap on error(Formal, Context) exceptions that unify. The tracer is started when a matching exception is raised. This predicate enables debug mode using debug/0 to get more context about the exception. Even with debug mode disabled exceptions are still trapped and thus one may call nodebug/0 to run in normal mode after installing a trap. Exceptions are trapped in any thread. Debug mode is only enabled in the calling thread. To enable debug mode in all threads use tdebug/0.

Calling debugging/0 lists the enabled traps. The predicate notrap/1 removes matching (unifying) traps.

In many cases debugging an exception that is caught is as simple as below (assuming run/0 starts your program).

?- gtrap(_).
?- run.
See also
- gtrap/1 to trap using the graphical debugger.
- Edit exceptions menu in PceEmacs and the graphical debugger that provide a graphical frontend to trap exceptions.