Difference between revisions of "TI-BASIC:Setupeditor"

From Learn @ Cemetech
Jump to navigationJump to search
(Initial automated import)
(Automated @@ correction)
Line 4: Line 4:
By default, works with L1-L6.
By default, works with L1-L6.
|syntax=SetUpEditor @@[@@''list'', ''list'',...]
|syntax=SetUpEditor <nowiki>[</nowiki>''list'', ''list'',...]
# STAT to enter the STAT menu.
# STAT to enter the STAT menu.

Latest revision as of 17:38, 24 February 2016


Command Summary

Sets which lists are shown in the List Editor. As a side effect, unarchives the lists, and creates them if they don't exist.

By default, works with L1-L6.

Command Syntax

SetUpEditor [list, list,...]

Menu Location


  1. STAT to enter the STAT menu.
  2. 5 to choose SetUpEditor, or use arrows.

Calculator Compatibility


Token Size

2 bytes

The SetUpEditor command is meant as an auxiliary for the List Editor (which can be accessed by pressing STAT ENTER (Edit...)). The list editor provides a convenient interface for looking at the elements in lists, or editing those elements (especially when the elements of two lists are connected to each other, such as a list for X-coordinates and one for Y-coordinates, since they will be shown in the same row).

The SetUpEditor command sets which lists are shown in this list editor. By default, it selects the lists L1, L2, L3, L4, L5, and L6. To do this, just use the command with no arguments:


However, you can use it to select any lists that you have defined, or even lists that you haven't defined yet. To do this, simply put the lists you want as arguments to the command. For example, if you want to edit the lists FOO and BAR, do:

:SetUpEditor FOO,BAR

The List Editor doesn't do anything when you are running a program, so it may seem as though SetUpEditor is nearly useless in programs. This is not the case, however, because of SetUpEditor's powerful side effect: if the lists it is given as arguments are archived, it will unarchive them. If they don't exist, it will create them with size 0.

Advanced Uses

Due to this side effect, SetUpEditor can be used for lists with external data such as saved games or high scores. When the user first runs the program, the assumption is you don't know anything about the state of those lists: they may be archived, or they may not even exist. You can deal with both of those individually: storing to the dimension will create the list if it didn't exist, and the UnArchive command will move the list to RAM if it wasn't there.

However, if you're wrong about the list, both of these commands will cause an error. If the list exists but is archived, storing to its dimension will cause an ERR:ARCHIVE error. If the list doesn't exist, unarchiving it will cause an ERR:UNDEFINED error. Sounds like a vicious circle.

The SetUpEditor command allows you to deal with both of these problems at once. Say the program saves its data in LSAVE. Use the SetUpEditor command on it, and from then on you know that the list exists AND that it is unarchived.

:SetUpEditor SAVE

At the end of the program, you should clean up after yourself, though. You don't want the user to see the list SAVE in the editor (he might be tempted to edit it and give himself a huge high score, for one thing). So you should use the SetUpEditor command again, this time without arguments, to reset the editor to its default state.

For more information about using SetUpEditor in the context of saving data, see the page on Saving.

Similar Commands

See Also