Texas Instruments TI-89 - Display_Statements

436
Appendix A: System Routines — Display
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
display_statements
Declaration:
HANDLE
display_statements
(EStackIndex
i
, Boolean
replace_newlines
,
Boolean
full_precision
)
Category(ies):
Display
Description:
Converts the external-tokenized form of an expression, statement, or group
of statements to linear ASCII text form.
Inputs:
i
— EStackIndex of external-tokenized expression,
statement, or group of statements.
replace_newlines
— TRUE to replace ‘\r’ characters with ‘:’; FALSE to
leave ‘\r’ characters as-is.
full_precision
— TRUE to display floating-point numbers with full
available precision. FALSE to display floating-point
numbers with precision determined by MODE
screen settings.
Outputs:
Returns the HANDLE to a heap packet which contains the ASCII text
result; returns H_NULL if memory full.
Assumptions:
None
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: Parse1DExpr
Example:
/* Assume i is the EStackIndex of the tagged floating-point number 3.1415926535898
and that the current MODE setting for Display Digits is FLOAT 6, then */
HANDLE h;
h = display_statements (i, TRUE, TRUE);
/* returns a HANDLE to a memory block containing the full precision
ASCII text 3.1415926535898. However, */
h = display_statements (i, TRUE, FALSE);
/* returns a HANDLE to a memory block containing the FLOAT 6 precision
ASCII text 3.14159. */