[ Type Testing | Reference Manual | Alphabetic Index ]

# is_handle(?Term)

Succeeds if Term is an object handle

Term
  Prolog term.

## Description

Used to test whether Term is a handle. Handles are references to anonymous ECLiPSe objects (such as streams, engines, bags, records, shelves, stores) or to external data created via the foreign language interfaces.

### Modes and Determinism

- is_handle(?) is semidet

### Fail Conditions

Fails if Term is not an external data handle

## Examples

        ?- bag_create(B), is_handle(B).
        B = $&(bag,"371bnb")
        Yes (0.00s cpu)

        ?- is_handle(_).
        No (0.00s cpu)

        ?- is_handle(42).
        No (0.00s cpu)

## See Also

is_handle / 2, is_event / 1, type_of / 2, xget / 3, xset / 3