Appendix A: System Routines — Symbol Table Utilities
1049
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
VarStore
Declaration:
HSYM
VarStore
(BYTE *
DestVar
, WORD
Flags
, WORD
SourceSize
,
[
parm1
] [,
parm2
])
Category(ies):
Symbol Table Utilities, Variables
Description:
This is the general system routine for storing to variables. It handles
system variables (some of which are not in the symbol table) as well as all
of the special cases for all variables throughout the system.
NOTE:
See the “Storing and Retrieving variable data” section in the Memory
Management chapter for further details on
VarStore
.
Inputs:
DestVar
— EStackIndex of variable name to store to.
Flags
— STOF_ESI, STOF_HESI, STOF_ELEMENT,
STOF_NONE, USER_FUN_TAG, TEXT_VAR_TAG,
GDB_VAR_TAG, PIC_VAR_TAG, DATA_VAR_TAG,
GEN_DATA_TAG
SourceSize
— Size of source.
Outputs:
Returns the HSYM of the newly created variable. Otherwise returns NULL
for system variables not in the symbol table.
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: VarRecall, TokenizeSymName
(continued)