[ Advanced Control and Suspensions | Reference Manual | Alphabetic Index ]

suspensions(?Var, -SuspensionList)

Retrieves a list of all suspensions attached to the variable Var.
Var
Any term.
SuspensionList
List or variable.

Description

Retrieves all live suspensions attached to the variable Var, and returns them in a duplicate-free list SuspensionList.

Note that this is a relatively expensive operation, involving collecting all suspensions lists from the variable's attributes via their respective suspensions-handlers, then removing duplicates and dead suspensions.

Modes and Determinism

Examples

[eclipse 2]: suspend:(X>5), suspensions(X, S).
X = X
S = ['SUSP-_256-susp']
Delayed goals:
        suspend : (X > 5)
yes.

[eclipse 3]: suspensions(X, S).
X = X
S = []
yes.

[eclipse 4]: suspensions(12, S).
S = []
yes.

See Also

suspensions / 1, subcall / 2, get_suspension_data / 3