SWI-Prolog -- intercept/3

Documentation
- Reference manual
  - The SWI-Prolog library
    - library(intercept): Intercept and signal interface
- Packages

Availability::- use_module(library(intercept)).(can be autoloaded)

intercept(:Goal, ?Ball, :Handler)

Run Goal as call/1. If somewhere during the execution of Goal send_signal/1 is called with a Signal that unifies with Ball, run Handler and continue the execution.

This predicate is related to catch/3, but rather than aborting the execution of Goal and running Handler it continues the execution of Goal. This construct is also related to delimited continuations (see reset/3 and shift/1). It only covers one (common) use case for delimited continuations, but does so with a simpler interface, at lower overhead and without suffering from poor interaction with the cut.

Note that Ball and Handler are copied before calling the (copy) of Handler to avoid instantiation of Ball and/or Handler which can make a subsequent signal fail.

See also: intercept/4, reset/3, catch/4, broadcast_request/1.
Compatibility: Ciao