[ Advanced Control and Suspensions | The ECLiPSe Built-In Predicates | 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

- suspensions(?, -) is det

## 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