1104
Appendix A: System Routines — Utilities
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
HToESI
Declaration:
EStackIndex HToESI (HANDLE
h
)
Category(ies):
Utilities
Description:
Convert HANDLE to EStackIndex pointer. If the handle is not locked,
HToESI
must be done again after heap compression since the block of
memory associated with the handle may have moved.
Inputs:
h
— Handle to a memory block containing the contents of a variable.
Outputs:
EStackIndex pointer to the data type tag of the variable, which is the
highest address of the variable data.
Assumptions:
The handle is valid.
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: HeapDeref
Example:
ptr = HToESI( h ); /* ptr=high address of memory block associated with handle h */
if( ESTACK( ptr ) == FLOAT_TAG ) /* Does block contain a tokenized
floating-point number? */
num = ESTACK_TO_FLOAT( ptr ); /* Yes, convert to BCD16 float in num. */
To Next Page
Loading...
