Ng_Rpntotext - Texas Instruments TI-89 Developer's Manual

1088

NG_RPNToText

Declaration: HANDLE NG_RPNToText (HANDLE hExpr , BOOL bRetToColon ,
BOOL bFullPrec )
Category(ies): Token Operations
Description: Converts the tokenized form of an expression, statement, or group of
statements as contained in the data referenced by the handle hExpr to
linear ASCII text form. The first word of the data must be the length of the
data which is used to find the first tag of the tokenized data.
Inputs: hExpr
bRetToColon — If TRUE, convert carriage returns to colons; otherwise
bFullPrec
Outputs: Returns the HANDLE to a heap packet which contains the ASCII text
result. Throws an ER_MEMORY error if not enough memory.
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: display_statements
Example: This example is a small viewer for variables of type EXPR, LIST, MAT, and
STR. These types are always tokenized (programs and functions may be in
text format).
/* Resource for vSym */
DIALOG dGetName, 0, 0, NoCallBack
{
EDIT, {0, 8, 15}, "", 0, 17, 18
HEADER, {0, 0, 0}, "Enter variable name, ESC to exit", PDB_OK, PDB_CANCEL
XFLAGS, {0, 0, 0}, XF_ALLOW_VARLINK | XF_VARLINK_SELECT_ONLY, 0, 0, 0
}
void vSym( void )
{ char inpBuf[MAX_SYM_LEN];
BYTE nameBuf[MAX_SYM_LEN];
HSYM hsym;
HANDLE hVal;
volatile HANDLE hText;
SYM_ENTRY *SymPtr;
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Token Operations
— Handle to tokenized object (first word is length of
object).
leave them alone.
— If TRUE convert floats to full precision; otherwise
convert floats according to the current mode settings.
(continued)
Not for Distribution Beta Version January 26, 2001