Texas Instruments TI-89 - Foldercur

Appendix A: System Routines — Symbol Table Utilities
1015
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
FolderCur
Declaration:
BOOL
FolderCur
(const BYTE *
FolderName
, BOOL
CheckGraphDirty
)
Category(ies):
Symbol Table Utilities
Description:
Make the given folder the default folder. Return TRUE if folder is valid, FALSE
otherwise.
CheckGraphDirty
should always be set to TRUE.
Inputs:
FolderName
— EStackIndex of folder name.
CheckGraphDirty
— Set to TRUE (if FALSE, the current graph can
become invalid).
Outputs:
TRUE — If successful.
FALSE — Invalid folder name.
Assumptions:
push_setfold
is similar except that
push_setfold
throws any errors and returns
the current previous default folder on the estack as well as updating the status line
with
ST_folder
.
NOTE:
Caller must call
ST_folder
to update the status line unless this is a temporary
folder.
Side Effects:
Status line is NOT updated to reflect current folder.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also:
push_setfold, push_getfold, FolderGetCur
Example:
WORD TokenizeFoldName( const char *strFileName, BYTE *TokFName );
DWORD NoCallBack( WORD DlgId, DWORD Value ) { return TRUE; }
/* Prompt the user for a folder name and set that to the current default folder.
If the user enters nothing or an invalid name, reprompt this time with the
current folder. Return TRUE if valid name entered, FALSE otherwise
*/
BOOL tFolderGetSet( void )
{ HANDLE dH = H_NULL;
BYTE szBuf[SYM_LEN+1], TokFName[MAX_SYM_LEN], *StrPtr;
(continued)