Immediately free (decrement the reference count) for the Python
object Obj. Further reference to Obj using e.g., py_call/2 or
py_free/1 raises an existence_error. Note that by decrementing the
reference count, we make the reference invalid from Prolog. This may
not actually delete the object because the object may have
references inside Python.
Prolog references to Python objects are subject to atom garbage
collection and thus normally do not need to be freed explicitly.
- Compatibility
- - PIP. The SWI-Prolog implementation is safe and normally
reclaiming Python object can be left to the garbage collector.
Portable applications may not assume garbage collection of Python
objects and must ensure to call py_free/1 exactly once on any Python
object reference. Not calling py_free/1 leaks the Python object.
Calling it twice may lead to undefined behavior.
