Appendix A: System Routines — Symbol Table Utilities
1017
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
FolderDel
Declaration:
BOOL
FolderDel
(const BYTE *
FolderName
, BOOL
SymsOnly
)
Category(ies):
Symbol Table Utilities (low-level)
Description:
Delete the given
FolderName
from the home folder. If a symbol in the
folder has a value (handle != NULL) then the memory for the value is
released. Return TRUE if it was deleted, FALSE if it was not found or was
not a folder. If
FolderName
was the current folder then the HOME folder
becomes the current folder. This routine can be used to delete all of the
symbols in MAIN but not MAIN itself.
If
SymsOnly
is TRUE then only the symbols within the folder (and their
values) are deleted, the folder name is kept in the symbol table.
NOTE:
This routine will delete all symbols in the folder even if they are locked, in-use,
or archived!
Inputs:
FolderName
— Pointer to tokenized folder name to delete.
SymsOnly
— TRUE to just delete symbols but leave folder.
Outputs:
TRUE if folder deleted, FALSE if the folder was not found.
Assumptions:
None
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: FolderAdd
Example:
See
FolderAdd
.