Appendix A: System Routines — Home Screen
625
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
HS_popEStack
Declaration:
HANDLE
HS_popEStack
(void)
Category(ies):
Home Screen
Description:
Pops the top element from the estack into heap memory.
Inputs:
None
Outputs:
Returns a handle to the popped contents.
Assumptions:
If there is insufficient memory to copy the estack into the heap, the estack
is popped anyway, and ER_MEMORY is thrown.
Side Effects:
May cause heap compression.
Availability:
All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
Differences:
None
See also:
None
Example:
HANDLE h;
.
.
.
TRY
h = HS_popEStack();
/* h now contains handle to popped estack */
ONERR
/* Could not allocate memory to pop estack */
.
.
.
ENDTRY