[ Non-logical Variables, Arrays, Bags, Shelves and Stores | Reference Manual | Alphabetic Index ]

bag_abolish(+BagHandle)

Destroy a bag explicitly
BagHandle
A bag handle

Description

This explicitly destroys a previously created bag object and frees all its memory. Invoking bag_abolish/1 is optional, the bag will be automatically destroyed when the system backtracks across the call to bag_create/1, or when the BagHandle is no longer needed and gets garbage collected. bag_dissolve/2 will also destroy the bag.

Using the BagHandle after it has been destroyed will lead to an error message. Destroying an already destroyed bag does nothing and is silently accepted.

Modes and Determinism

Exceptions

(4) instantiation fault
BagHandle is not instantiated
(5) type error
BagHandle is not a bag
(40) stale object handle
BagHandle refers to an already destroyed bag

See Also

bag_create / 1, bag_enter / 2, bag_count / 2, bag_erase / 1, bag_retrieve / 2, bag_dissolve / 2