Maintenance script: Initial automated import

2016-02-24T18:21:18Z

Initial automated import

New page

{{Template:TI-BASIC:Command
|picture=ARCHIVE.GIF
|summary=Moves a variable from RAM to the archive.
|syntax=Archive ''variable''
|location=Press:
# 2nd MEM to access the memory menu
# 5 to select Archive, or use arrows
|compatibility=TI-83+/84+/SE

(not available on the regular TI-83)
|size=2 bytes
}}

The Archive command moves a variable from [[TI-BASIC:Glossary#ram|RAM]] to the archive (also known as [[TI-BASIC:Glossary#tom|ROM]]). A quick synopsis of the difference between the two:
* Data in the archive cannot be accessed, but it's protected from RAM clears (which may occur during battery removal if not done carefully); also, the archive can hold much more data.
* Data in RAM can be accessed for calculations, but it can also be deleted during a RAM clear or accidentally overwritten by another program.

Nothing happens if the variable in question is already archived.

You might want to use this command to protect data such as saved games from being accidentally deleted. It's not, in general, a good idea to archive commonly used variables, such as the real variables A-Z, since programs usually expect to be able to access these variables without problems, and won't check if they're archived.

Also, some variables cannot be archived. These include:
* The real variables R, T, X, Y, θ, and ''n'' (due to their use in graphing)
* The [[TI-BASIC:System_Variables#equation|equation]] variables Y,,n,,, X,,nT,,, Y,,nT,,, r,,n,,, u, v, and w
* The stat plots Plot''#''
* [[TI-BASIC:System_Variables#window|Window]], table, and zoom variables such as TblInput or Xmin
* [[TI-BASIC:System_Variables#statistical|Statistical]] variables and the list ∟RESID
* [[TI-BASIC:System_Variables#finance|Finance]] variables

Finally, the Archive command does not work on programs when using it from a program (it does, however, archive programs from the home screen). However, an [[TI-BASIC:Hexcodes#toc0|assembly program]] can be executed as a subroutine so that Archive and UnArchive can be used within a program. The program should however be run again afterwards.

= Advanced Uses =

As archived variables (and programs) can not be accessed by the calculator's inbuilt OS, archiving programs can be quite problematic when trying to execute them. However; by enabling your programs to be viewable in [[TI-BASIC:Asmshells|assembly shells]], you can execute your programs without needing to unarchive them first. This is because the assembly shell ''copies'' the program to the RAM automatically, and is then executed. Closing the program will automatically remove the copy from the RAM, so no RAM is lost in the end.

= Error Conditions =

* '''[[TI-BASIC:Errors#archivefull|ERR:ARCHIVE FULL]]''' is thrown when there isn't enough space in the archive for the variable.
* '''[[TI-BASIC:Errors#invalid|ERR:INVALID]]''' is thrown when trying to archive a program from within a program.
* '''[[TI-BASIC:Errors#variable|ERR:VARIABLE]]''' is thrown when trying to archive a variable that cannot be archived.

= Related Commands =

* [[TI-BASIC:Unarchive|UnArchive]]
* [[TI-BASIC:Delvar|DelVar]][[Category:TI-BASIC]]
[[Category:TIBD]]

TI-BASIC:Archive - Revision history

Maintenance script: Initial automated import