Texas Instruments TI-89 - Cmd_Archive

1130
Appendix A: System Routines — Variables
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
cmd_archive
Declaration:
void
cmd_archive
(EStackIndex
ePtr
)
Category(ies):
Variables
Description:
Archive one or more variables. This is the TI
-
BASIC archive command.
Inputs:
ePtr
— EStackIndex of variable name(s) to archive (terminated by an
END_TAG).
Outputs:
May throw these errors:
ER_RESERVED — Reserved names may not be archived.
ER_UNDEFINED_VAR — Variable not found.
ER_VAR_IN_USE — Variable in use.
ER_INVALID_VAR_REF — Cannot archive local variables.
ER_MEMORY — Not enough memory (Flash).
Assumptions:
None
Side Effects:
May cause heap compression.
Availability:
On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences:
None
See Also: cmd_unarchiv
Example:
This function archives or unarchives a variable passed as a string name.
BOOL ArchiveVar( char *szBuf, BOOL archive )
{ Access_AMS_Global_Variables;
EStackIndex oldTop;
oldTop = top_estack;
TRY
push_quantum( END_TAG );
if (TokenizeSymName( (BYTE *) szBuf, 0 ) == NULL)
ER_THROW( INVALID_PATHNAME_ERROR );
archive ? cmd_archive( top_estack ) : cmd_unarchiv( top_estack );
ONERR
top_estack = oldTop;
ERD_dialog( errCode, FALSE );
return FALSE;
ENDTRY
top_estack = oldTop;
return(TRUE);
}