Appendix A: System Routines — Symbol Table Utilities
1047
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
VarRecall
Declaration:
HSYM
VarRecall
(BYTE *
Var
, RECALL_FLAGS
Flag
)
Category(ies):
Symbol Table Utilities, Variables
Description:
Recalls a variable, returning its HSYM or NULL if not found. Note that this
routine handles system variables even if they are not in the symbol table.
NOTE:
See the “Storing and Retrieving variable data” section in the Memory
Management chapter for further details on
VarRecall
.
Inputs:
Var
— EStackIndex of variable name to look-up.
Flags
—
VR_NO_SYS_VARS
Throw an error if the variable to look-up
is a system variable.
Outputs:
Returns the HSYM of the variable to look-up, NULL if the variable is not
found.
Assumptions:
None
Side Effects:
Some system variables are not in the symbol table and so
VarRecall
returns a dummy HSYM which is shared by all such variables. Thus the
next call to
VarRecall
for such a variable will return the same HSYM but
with a different value (and the previous HSYM will be invalid). So if
VarRecall
is used for system variables it is best to keep a copy of the value
pointed to by the HSYM if it is needed.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: VarStore, TokenizeSymName
(continued)
To Next Page
Loading...
Need help?
General
