Toktostrn - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Variable Name Utilities

TokToStrN

Declaration: BOOL TokToStrN (BYTE * StrSymName , const BYTE * TokPtr )
Category(ies): Variable Name Utilities
Description: Convert a tokenized symbol name into an ASCIIZ string. This routine does
not handle reserved names.
StrSymName — Pointer to buffer of MAX_SYM_LEN chars.
Inputs:
TokPtr
Outputs: Return TRUE if symbol converted, FALSE if TokPtr does not point to a tag
that represents a variable or is a reserved variable name.
StrSymName — ASCIIZ version of name.
Assumptions: None
Side Effects: None
Availability: All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
Differences: None
See Also: StrToTokN, TokenizeSymName, TokenizeName
Example: This is an example TI-BASIC callable routine that is passed the name of a
file name. Since the FILE system uses ASCIIZ terminated names,
TokToStrN is used to convert the input name into ASCIIZ format.
void _FCount(void)
{ Access_AMS_Global_Variables;
char fName[MAX_SYM_LEN];
if (!TokToStrN( (BYTE *) fName, top_estack ))
ER_throw( EXPECTED_VAR_ERROR );
.
.
.
/* fName will be passed to the FILE routines like FOpen */
}
TI-89 / TI-92 Plus Developer Guide
— Pointer to a tokenized symbol name that is not a
reserved variable.
Not for Distribution
1125
Beta Version January 26, 2001