Texas Instruments TI-89 - Push_Setfold

1026
Appendix A: System Routines — Symbol Table Utilities
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
push_setfold
Declaration:
void
push_setfold
(EStackIndex
foldName
)
Category(ies):
Symbol Table Utilities
Description:
Make the given folder the default folder. This is the TI
-
BASIC function
setFold. Returns the current previous default folder on the estack as a
string (STR_DATA_TAG). Updates the status line with the new folder
name.
Inputs:
foldName
— EStackIndex of folder name.
Outputs:
May throw these errors:
ER_ILLEGAL_IN_FUNC — The default folder cannot be
changed inside a function.
ER_INVALID_FOLDER_NAME,
INVALID_PATHNAME_ERROR
— Invalid folder name.
Assumptions:
None
Side Effects:
Unlike
FolderCur
, this routine updates the status line.
Availability:
On AMS 1.05 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: push_getfold, FolderCur
Example:
Compare this example to the example for
FolderCur
. This example
(1) uses a static dialog box, listed at the end, (2) uses XR_FolderC which is
a system string reference and will be automatically translated by the
current localizer, and (3) uses XFLAGS with XF_ALLOW_VARLINK set so
the user can pop-up VAR-LINK within the dialog box and paste folder
names.
(continued)