Texas Instruments TI-89 - Oo_Deref

310
Appendix A: System Routines — Apps
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
OO_Deref
Declaration:
Frame *
OO_Deref
(pFrame
pointer
)
Category(ies):
Apps, Memory Management
Description:
Object frame pointers (type pFrame) come in three flavors: handles,
address pointers, and indirect references to the system object frame. This
routine figures out the flavor of
pointer
and translates it into a real address.
Given the real address, the frame’s header and attributes can be directly
accessed.
Inputs:
pointer
— An object frame pointer.
Outputs:
Returns address of frame referenced by
pointer
.
Assumptions:
None
Side Effects:
None
Availability:
On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences:
None
See Also:
None
Example:
pFrame obj;
Frame *pobj;
ULONG i;
.
.
.
obj = OO_New(H_NULL); /* allocate new frame from the heap */
pobj = OO_Deref(obj); /* get pointer to frame */
for (i = 0; i < pobj->head.count; i += 1)
{
/* process each attribute of object frame */
.
.
.
}