Folderadd - Texas Instruments TI-89 Developer's Manual

1012

FolderAdd

Declaration: HANDLE FolderAdd (const BYTE * FolderName )
Category(ies): Symbol Table Utilities (low-level)
Description: Add the given FolderName to the home folder. Return the HANDLE of the
new folder if OK, H_NULL if error (not enough memory or folder already
exists). Note that reserved names are not valid folder names and that this
routine does not check for reserved names. It is up to the caller to validate
the folder name before calling this routine. In general, cmd_newfold
should be used to create folders. This routine can be used to create
temporary folders which begin with a number and are not displayed in
VAR-LINK. The following temporary folder numbers are reserved for the
system (they are all four digit numbers):
0001 . . . 8192 — TI-BASIC local symbols.
9998
9999
FolderName
Inputs:
HANDLE of new folder or H_NULL if an error.
Outputs:
None
Assumptions:
Side Effects: May cause heap compression.
Availability: All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
Differences: None
See Also: cmd_newfold, AddSymToFolder, FindSymInFolder
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Symbol Table Utilities
— Data/Matrix Editor.
— Reserved.
— Pointer to tokenized folder name to create.
(continued)
Not for Distribution Beta Version January 26, 2001