Texas Instruments TI-89 Developer's Guide

1012
Appendix A: System Routines — Symbol Table Utilities
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
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 — Data/Matrix Editor.
9999 — Reserved.
Inputs:
FolderName
— Pointer to tokenized folder name to create.
Outputs:
HANDLE of new folder or H_NULL if an error.
Assumptions:
None
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
(continued)

Texas Instruments TI-89 Specifications

General

Display size (HxV)	100 x 160 mm
Memory type	639K FLASH ROM, 188K bytes RAM
Compatible operating systems	Operating System 2.09
Battery type	AAA