Normal Symbol Routines - Texas Instruments TI-89 Developer's Manual

136
The system variables and reserved function names is a finite list that is defined in
Appendix B of the TI-89 / TI-92 Plus Guidebook and cannot be used for anything
else. The system commands and functions are also reserved; but an application
localizer can redefine their spelling for a particular language. Thus, the list of
system commands and functions is open-ended. In order to allow for redefined
system command and function names, an app can append a digit to each name
it uses which will insure that the name does not conflict with any reserved names
(as long as it does not conflict with a system variable or reserved function name).
As an example: In English, an app can create a variable called EXAKT and store
any value to it. If the same app is run in German, storing to the variable EXAKT
will cause an error because that is the redefined system function for "exact(". But
the app could store to EXAKT0 instead and not worry about a name conflict.
13.3.1.

Normal Symbol Routines

In general, an app should use the file system to store any permanent data. The
low-level symbol table routines assume the caller knows precisely which
variables are being worked on. Thus, these routines do limited checking for
things like locked, in-use or invalid variable names as well as no type checking.
The TI-BASIC variable routines are available to call and, unlike the low-level
routines, they do extensive checking. Their parameters are passed on the estack
and all errors cause exceptions. These routines are:
cmd_archive
cmd_copyvar
cmd_delfold
cmd_delvar
cmd_lock
cmd_movevar
cmd_newfold
cmd_rename
cmd_unarchiv
cmd_unlock
DerefSym
FolderCur
FolderGetCur
push_getfold
TI-89 / TI-92 Plus Developer Guide
Chapter 13: Memory Management
— Archive one or more variables.
— Copy one variable to another.
— Delete one or more empty folders.
— Delete one or more variables.
— Lock one or more variables.
— Move a variable from one folder to another.
— Create a new folder.
— Rename a variable or folder.
— Unarchive one or more variables.
— Unlock one or more variables.
— Dereference an HSYM, returning a pointer to a
SYM_ENTRY.
— Set current default folder.
— Get current default folder.
— Get current default folder (TI-BASIC version of
FolderGetCur).
Not for Distribution Beta Version January 26, 2001