release

Destroy a handle’s C object now, ahead of its last reference.

Synopsis

Peta::FFI::release($schema);    # schema_free runs here

What you get back

True when the object was destroyed; false when $handle is no handle or was released already. A released handle stays an object of its class, and passing it to C croaks.