FolderCur Function (ROM Call 0x65)

vat.h

short FolderCur (SYM_STR SymName, short nonSys);

Sets the currently active folder.

FolderCur sets the currently active folder to SymName (see SYMSTR for rules about SymName). It returns TRUE if the operation was successful, else returns FALSE (e.g. if the folder name is invalid).

nonSys is a boolean flag which normally needs to be TRUE. If it is set to TRUE, FolderCur calls SymFindNext repeatedly until the first non-system variable in this folder is reached. This is necessary, else the current graph may become invalid. In particular, if the graph references a variable defined in a folder which previously was the current folder, it is not redrawn if nonSys is set to FALSE.

Note: The folder name in the status line will not be changed automatically using this command. You must change it manually using the function ST_folder from statline.h.

This routine may cause heap compression.


Uses: CheckSysFunc, SymCmp, SymCpy, SymCpy0, SymFindFirst, SymFindNext, TokToStrN, gr_active, gr_other, strcmp, statFree, _mu16u16
Used by: cmd_newfold, push_setfold, MO_digestOptions


See also: FolderGetCur, FolderCurTemp