 |
FolderAdd |
Function (ROM Call 0x64) |
Creates a folder.
FolderAdd creates a new folder with name SymName. See
SYMSTR for rules about SymName. FolderAdd returns
a handle to the created folder (more precise, to the VAT variable list which belongs to
the created folder). Returns H_NULL in a case of error (for example, the folder
already exists, or there is not enough memory). 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. This routine may cause heap compression.
This routine also can be used to create temporary folders
(see also FolderAddTemp) whose names begin with a number and are not
displayed in VAR-LINK dialog. Temporary folder numbers '0001'...'8192' are reserved for
keeping TI-BASIC local symbols, folder number '9998' is used in Data/Matrix Editor,
and folder number '9999' is reserved for various temporary storage.
Uses: SymCmp, SymCpy, TokToStrN, HeapAlloc, HeapFree, HeapRealloc, memmove, _mu16u16, _ds32s32
Used by: FolderAddTemp, SymFindPtr, cmd_blddata, cmd_movevar, cmd_newfold, gr_openFolder
See also: FolderAddTemp, SymAdd