Texas Instruments TI-89 - Hsymdel

1022
Appendix A: System Routines — Symbol Table Utilities
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
HSymDel
Declaration:
void
HSymDel
(HSYM
hsym
)
Category(ies):
Symbol Table Utilities
Description:
Delete a variable using an HSYM. If the symbol has a value, its memory is
also released.
Inputs:
hsym
— HSYM of a variable to delete.
Outputs:
Nothing is returned since it is assumed
hsym
is a valid HSYM; may throw
the following errors:
ER_RESERVED — Can not delete MAIN folder.
ER_VAR_IN_USE — Variable is in use.
ER_LOCKED — Variable is archived (available in 2.04 and above).
Assumptions:
The caller must be sure the symbol table has not been changed since the
HSYM was obtained.
NOTE:
If called to delete a folder than that folder MUST be empty! Also do not use to
delete twin or archived variables.
Side Effects:
As with all routines that modify the symbol table, this routine invalidates
any other existing HSYMs.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: cmd_delvar, cmd_delfold, SymDel, FolderDel
(continued)