Hs_Popestack - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Home Screen

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.
All versions of the TI-89 / TI-92 Plus.
Availability:
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
TI-89 / TI-92 Plus Developer Guide Not for Distribution
625
Beta Version January 26, 2001