Texas Instruments TI-89 - Oo_Destroyall

312
Appendix A: System Routines — Apps
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
OO_DestroyAll
Declaration:
pFrame
OO_DestroyAll
(pFrame
obj
)
Category(ies):
Apps
Description:
Releases space from an object frame, its prototype chain, its parent chain,
and all their prototype chains. Use this routine to free frames allocated by
OO_New
.
Inputs:
obj
— Pointer to first object frame in prototype and parent chain to free.
Outputs:
Returns a pointer to the first frame in the parent chain which could not be
freed (resides in Flash memory) or H_NULL if the entire parent chain was
freed.
Assumptions:
The parent chain of an object frame frequently ends with a Flash-resident
frame, either a frame in your app or the system frame. This routine does
not attempt to free a frame which resides in Flash memory.
Side Effects:
None
Availability:
On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences:
None
See Also: OO_Destroy, OO_New
Example:
pFrame obj;
.
.
.
obj = OO_New(H_NULL); /* allocate a new object */
.
. /* add more frames to parent chain of obj */
.
OO_DestroyAll(obj); /* free object and its parent and prototype chains */