Texas Instruments TI89 Developer Guide - Page 178
Normal Symbol Routines, Appendix B of the TI
UPC - 033317198566
View all Texas Instruments TI89 manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 178 highlights
136 Chapter 13: Memory Management 13.3.1. 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. 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 - 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). TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001