Push_Char - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Strings

push_char

Declaration: void push_char (EStackIndex i )
Category(ies): Strings
Description: Pushes a string containing the specified ASCII character.
Inputs: i
Outputs: Pushes a tokenized string onto the estack containing the ASCII character
specified by the input value. If the input is a list of numbers, the routine
returns the corresponding list of strings.
Assumptions: None
Side Effects: May cause expression stack to grow or heap compression. Will throw an
error if the input is not a whole number or is outside the input domain.
Availability: On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences: None
See Also: push_format, push_instring, push_ord, push_str_to_expr,
push_string, push_zstr
Example:
If j indexes the bolded tag in the integer 65 as follows
65 1 NONNEGATIVE_INTEGER_TAG
then
push_char (j);
pushes the string "A" onto the stack such that top_estack points to the bolded tag as follows.
0 65 0 STR_DATA_TAG
TI-89 / TI-92 Plus Developer Guide
— EStackIndex of a number between 0 and 255, inclusive.
Not for Distribution
979
Beta Version January 26, 2001