FolderAdd Function (ROM Call 0x64)

vat.h

HANDLE FolderAdd (SYM_STR SymName);

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