| Did you know ... | Search Documentation: |
| object->free |
->free
performs the following steps:
->unlink.
This allows a class to unlink the object from the environment.<-references.
Otherwise reclaim is delayed. See pce<-deferred_unalloced.
object->unlink
is often defined on objects that need to inform some other object that
they are destroyed. For example, graphical
objects inform their device to allow the device to remove the object
from the display and update their book-keeping.
The method object->unlinking
is provided as a test whether or not object->free
is in progress on the receiver.
See also visual->destroy
to destroy entire hierarchies of (visual) objects.
Diagnostics: Fails silently if object<->protect
equals @on.
Bugs: Window object->free
should just delete the window from it's object<-frame.
In new code, please delete frames using object->free.
->unlink ->destroy ->protect ->destroy ->_free