Texas Instruments TI-89 - Oo_New

322
Appendix A: System Routines — Apps
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
OO_New
Declaration:
pFrame
OO_New
(pFrame
prototype
)
Category(ies):
Apps
Description:
Allocates a new object frame from heap memory. Frame
prototype
is linked
to the prototype hierarchy of the new frame.
Inputs:
prototype
— Pointer to prototype object. You may pass H_NULL for this
parameter if you do not want to link the new object into a
prototype hierarchy.
Outputs:
Returns a frame pointer to the new object or H_NULL if memory for the
object could not be allocated out of the heap.
Assumptions:
None
Side Effects:
May cause heap compression.
Availability:
On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences:
None
See Also: OO_Destroy, OO_DestroyAll
Example:
pFrame obj;
.
.
.
obj = OO_New(H_NULL); /* allocate a new object */
if (obj != H_NULL)
{
.
. /* use object */
.
OO_Destroy(obj); /* free object */
}