Htoesi - Texas Instruments TI-89 Developer's Manual

1104

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.
h — Handle to a memory block containing the contents of a variable.
Inputs:
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 )
num = ESTACK_TO_FLOAT( ptr );
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Utilities
/* Does block contain a tokenized
floating-point number? */
/* Yes, convert to BCD16 float in num. */
Not for Distribution Beta Version January 26, 2001