key SciMax Toolbox killcontext

SciMax Toolbox >> kill

kill

Maxima Function

Calling Sequence

kill (a_1, ..., a_n)
kill(labels)
kill(inlabels,outlabels,linelabels)
kill(n)
kill([m,n])
kill(values,functions,arrays,...)
kill(all)
kill(allbut(a_1,...,a_n))

Description

Removes all bindings (value, function, array, or rule) from the arguments a_1, ..., a_n. An argument a_k may be a symbol or a single array element. When a_k is a single array element, kill unbinds that element without affecting any other elements of the array.

Several special arguments are recognized. Different kinds of arguments may be combined, e.g., kill (inlabels, functions, allbut (foo, bar)).

kill (labels) unbinds all input, output, and intermediate expression labels created so far. kill (inlabels) unbinds only input labels which begin with the current value of inchar. Likewise, kill (outlabels) unbinds only output labels which begin with the current value of outchar, and kill (linelabels) unbinds only intermediate expression labels which begin with the current value of linechar.

kill (n), where n is an integer, unbinds the n most recent input and output labels.

kill ([m, n]) unbinds input and output labels m through n.

kill (infolist), where infolist is any item in infolists (such as values, functions, or arrays) unbinds all items in infolist. See also .

kill (all) unbinds all items on all infolists. kill (all) does not reset global variables to their default values; see reset on this point.

kill (allbut (a_1, ..., a_n)) unbinds all items on all infolists except for a_1, ..., a_n. kill (allbut (infolist)) unbinds all items except for the ones on infolist, where infolist is values, functions, arrays, etc.

The memory taken up by a bound property is not released until all symbols are unbound from it. In particular, to release the memory taken up by the value of a symbol, one unbinds the output label which shows the bound value, as well as unbinding the symbol itself.

kill quotes its arguments. The quote-quote operator '@w' defeats quotation.

kill (symbol) unbinds all properties of symbol. In contrast, remvalue, remfunction, remarray, and remrule unbind a specific property.

kill always returns done, even if an argument has no binding.

key SciMax Toolbox killcontext