Texas Instruments TI-89 - Cmd_Delfold

1132
Appendix A: System Routines — Variables
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
cmd_delfold
Declaration:
void
cmd_delfold
(EStackIndex
foldName
)
Category(ies):
Variables
Description:
Delete one or more empty folders. This is the TI
-
BASIC command DelFold.
Inputs:
foldName
— EStackIndex of folder name(s) to delete (terminated by an
END_TAG).
Outputs:
May throw these errors:
ER_LOCKED — Folder is locked or in-use.
ER_ARG_MUST_BE_EMPTY_FOLDER — Folder must be empty.
Assumptions:
None
Side Effects:
None
Availability:
On AMS 1.05 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: TokenizeSymName, cmd_newfold
Example:
Note that this example uses
TokenizeSymName
and not
TokenizeName
which does not work for folder names.
void DelFold( BYTE *foldName ) {
EStackIndex oldTop = top_estack; /* save top of ESTACK */
TRY
push_quantum (END_TAG); /* mark end of parameter list */
if (TokenizeSymName( foldName, 0 ) == NULL) /* push tokenized name on ESTACK */
ER_THROW( INVALID_PATHNAME_ERROR );
cmd_delfold(top_estack);
top_estack = oldTop; /* restore top of ESTACK */
ONERR
top_estack = oldTop; /* restore top of ESTACK */
PASS; /* pass error on up to caller */
ENDTRY
}