Texas Instruments TI-89 - Push_Between

528
Appendix A: System Routines — EStack Utilities
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
push_between
Declaration:
void
push_between
(IndexConstQuantum
low
, IndexConstQuantum
high
)
Category(ies):
EStack Utilities
Description:
Pushes quantums indexed from (
low
+ 1) through
high
onto the estack if
space is available or can be made available.
Inputs:
low
— Index one quantum below the lowest quantum of the data.
high
— Indexes the top tag of the data.
Outputs:
None
Assumptions:
low
≤
high
— Both
low
and
high
point to the estack or the same locked
block.
Side Effects:
Throws ESTACK_OVERFLOW_ERROR if there is not enough space left
on the estack. May cause heap compression. Throws ER_BREAK error if
the
´
key has been pressed to interrupt execution.
Availability:
On AMS 1.05 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: push_expression, push_quantum
Example:
void move_between_to_top (EStackIndex i, EStackIndex j)
/* Copies elements from i + 1 through j to top of estack,
then deletes elements from i + 1 through j.
*/
{ push_between (i, j);
delete_between (i, j);
}