Texas Instruments TI-89 - Toktostrn

Appendix A: System Routines — Variable Name Utilities
1125
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
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.
Inputs:
StrSymName
— Pointer to buffer of MAX_SYM_LEN chars.
TokPtr
— Pointer to a tokenized symbol name that is not a
reserved variable.
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 */
}