Table 7.1 describes the list operators and their syntax.
|
|
As List() |
As List(matrix) |
|||||
= += -= *= /= ++ -- |
Assign() Add To() SubtractTo() MultiplyTo() DivideTo() Post Increment() Post Decrement() |
{list} = {list} {list} += value {list} -= {list} ... |
|
||||
||= |
Concat To() |
Concat To(list1, list2, ...) |
|||||
|| |
Concat() |
Concat(list1, list2, ...); |
|||||
|
|
Eval List() |
Eval List(list) |
|||||
|
|
Insert Into() |
Insert Into(list, x, <i>) |
Inserts a new item (x) into the list at the given position (i). If i is not given, the item is added to the end of the list. This function does change the original list.
|
||||
|
|
Insert() |
list = Insert(list, x, <i>) |
Returns a copy of the list with a new item (x) inserted into the list at the given position (i). If i is not given, the item is added to the end of the list. This function does not change the original list.
|
||||
|
|
Is List() |
Is List(arg) |
Returns true (1) if arg is a classical list (in other words, one that would result from the construction by List(items) or {items}) and returns false (0) otherwise. An empty list is still a list, so IsList({ }) returns true. If miss=., then IsList(miss) returns false, not missing.
|
||||
{ } |
List |
List(a, b, c) {a, b, c} |
Constructs a list from a set of items. An item can be any expression, including other lists. Items must be separated by commas. Text should either be enclosed in double quotation marks ( " " ) or stored in a variable and called as that variable.
|
||||
|
|
N Items |
N Items(list) |
Returns the number of elements in the list specified. Can be assigned to a variable.
|
||||
|
|
Remove From() |
Remove From(list, <i>, <n>) |
Deletes n items from the list, starting from the indicated position (i). If n is omitted, the item at i is deleted. If n and i are omitted, the item at the end is removed. This function does change the original list.
|
||||
|
|
Remove() |
Remove(list, <i>, <n>) |
Returns a copy of the list with the n items deleted, starting from the indicated position (i). If n is omitted, the item at i is deleted. If n and i are omitted, the item at the end is removed. This function does not change the original list.
|
||||
|
|
Reverse Into() |
Reverse Into(list) |
Reverses the order of the items in the list. This function does change the original list.
|
||||
|
|
Reverse() |
Reverse(list) |
Returns a copy of the list with the items in reverse order. This function does not change the original list.
|
||||
|
|
Shift Into() |
Shift Into(list, <n>) |
Shifts n items from the front of the list to the end of the list. If n is omitted, the first item is moved to the end of the list. This function does change the original list.
|
||||
|
|
Shift() |
Shift(list, <n>) |
Returns a copy of the list with n items shifted from the front of the list to the end of the list. If n is omitted, the first item is moved to the end of the list. This function does not change the original list.
|
||||
|
|
Sort Ascending() |
Sort Ascending(list) |
Returns a copy of the list sorted in ascending order. This function does not change the original list.
|
||||
|
|
Sort Descending() |
Sort Descending(list) |
Returns a copy of the list sorted in descending order. This function does not change the original list.
|
||||
|
|
Sort List Into() |
Sort List Into(list) |
Sorts the list in ascending order. This function does change the original list.
|
||||
|
|
Sort List() |
Sort List(list) |
Returns a copy of the list sorted in ascending order. This function does not change the original list.
|
||||
[ ] |
Subscript() |
list[i] x = list[i] list[i] = value a[b, c] Subscript(a, b, c) |
Subscripts for lists extract the ith item from the list. Subscripts can in turn be lists or matrices.
|
||||
|
|
Substitute() |
Substitute(list, pattExpr1, replExpr1, ...) |
|||||
|
|
Substitute Into() |
Substitute Into(list, pattExpr1, replExpr1, ...) |
Changes a string, list, or expression, replacing instances of each pattern expression with the corresponding replacement expression. Note: The list or expression must be a variable. See Substitute and Substitute Into in Types of Data.
|
||||