Folderdel - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Symbol Table Utilities

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,
Inputs: FolderName — Pointer to tokenized folder name to delete.
SymsOnly
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.
TI-89 / TI-92 Plus Developer Guide
or archived!
— TRUE to just delete symbols but leave folder.
Not for Distribution
1017
Beta Version January 26, 2001