Maintenance script: Automated @@ correction

2016-02-24T21:40:17Z

Automated @@ correction

← Older revision		Revision as of 21:40, 24 February 2016
Line 2:		Line 2:
	\|picture=CLRLIST.GIF		\|picture=CLRLIST.GIF
	\|summary=Sets the dimension of a list or lists to 0.		\|summary=Sets the dimension of a list or lists to 0.
	\|syntax=ClrList ''list1'', @@[@@''list2'', ''list3'', ...]		\|syntax=ClrList ''list1'', <nowiki>[</nowiki>''list2'', ''list3'', ...]
	\|location=Press:		\|location=Press:
	# STAT to access the statistics menu		# STAT to access the statistics menu

Maintenance script: Initial automated import

2016-02-24T18:39:07Z

Initial automated import

New page

{{Template:TI-BASIC:Command
|picture=CLRLIST.GIF
|summary=Sets the dimension of a list or lists to 0.
|syntax=ClrList ''list1'', @@[@@''list2'', ''list3'', ...]
|location=Press:
# STAT to access the statistics menu
# 4 to select ClrList, or use arrows.
|compatibility=TI-83/84/+/SE
|size=1 byte
}}

ClrList sets the length of a list (or several lists) to 0. This is virtually equivalent to deleting the list, except for two differences:

* The list still exists -- it will be shown in the memory management menu and the list menu
* Calling the [[TI-BASIC:Dim|Dim(]] command on it will return 0, rather than an error.

In practice, there is rarely a reason to use this command over [[TI-BASIC:Delvar|DelVar]].

= Advanced Uses =

You might use ClrList when building up a list element by element and using dim( in the process:

:ClrList L1
:While 10>dim(L1
:Input X
:X→L1(1+dim(L1
:End

You may be thinking to yourself, "That is an extremely contrived example!" That's because that is an extremely contrived example. The truth is there is no good reason to use ClrList.

= Optimization =

Using [[TI-BASIC:Delvar|DelVar]] instead of ClrList allows you to save a tiny bit of memory (between 12 and 16 bytes) that ClrList doesn't delete, while keeping almost every aspect of the list clearing the same.

= Error Conditions =

* '''[[TI-BASIC:Errors#syntax|ERR:SYNTAX]]''' is thrown if you leave off the [[TI-BASIC:L|∟]] symbol when referring to a custom list (i.e., ClrList B will not work; you have to use ClrList ∟B).

= Related Commands =

* [[TI-BASIC:Clralllists|ClrAllLists]]
* [[TI-BASIC:Delvar|DelVar]]
* [[TI-BASIC:Dim|Dim(]][[Category:TI-BASIC]]
[[Category:TIBD]]

TI-BASIC:Clrlist - Revision history

Maintenance script: Automated @@ correction

Maintenance script: Initial automated import