Cmd_Archive - Texas Instruments TI-89 Developer's Manual

1130

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
Outputs: May throw these errors:
ER_RESERVED
ER_UNDEFINED_VAR
ER_VAR_IN_USE
ER_INVALID_VAR_REF — Cannot archive local variables.
ER_MEMORY
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);
}
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Variables
END_TAG).
— Reserved names may not be archived.
— Variable not found.
— Variable in use.
— Not enough memory (Flash).
Not for Distribution Beta Version January 26, 2001