1complement
2
3 SYNOPSIS
4  Extract the elements of a set that are not contained in other sets.
5
6 USAGE
7  indices = complement (a, b, ..., c)
8
9 DESCRIPTION
10  This function computes the elements of the first argument (`a')
11  that are not contained in the sets given by the other arguments
12  (`b,...,c') and returns them in the form of indices into the
13  first argument.
14
15 EXAMPLE
16
17   a = {"foo", PI, 7};
18   b = [1,2,3,PI];
19   indices = complement (a, b);
20
21  Upon return, `indices' will have the value `[0, 2]' since
22  `a[0]' and `a[2]' are not contained in `b'.
23
24 NOTES
25  A set may either be an Array_Type or a List_Type object.
26  For a homogeneous collection of objects, it is better to
27  use an Array_Type. i.e., `[1,2,3]' instead of `{1,2,3}'.
28
29 SEE ALSO
30  intersection, ismember, union, unique
31
32--------------------------------------------------------------
33
34intersection
35
36 SYNOPSIS
37  Extract the common elements of two or more sets
38
39 USAGE
40  indices = complement (a, b, ..., c)
41
42 DESCRIPTION
43  This function computes the common elements of two or more sets and
44  returns them in the form of indices into the first argument.
45
46 EXAMPLE
47
48   a = {"foo", 7, PI};
49   b = {PI, "bar", "foo"};
50   indices = intersection (a, b);
51
52  Upon return, `indices' will have the value `[0, 2]' since
53  `a[0]' and `a[2]' are the common elements of the sets.
54
55 NOTES
56  A set may either be an Array_Type or a List_Type object.
57  For a homogeneous collection of objects, it is better to
58  use an Array_Type. i.e., `[1,2,3]' instead of `{1,2,3}'.
59
60 SEE ALSO
61  complement, ismember, union, unique
62
63--------------------------------------------------------------
64
65ismember
66
67 SYNOPSIS
68  test to see if the elements of one set are members of another
69
70 USAGE
71  val = ismember (a, b)
72
73 DESCRIPTION
74  This function may be used to see which of the elements of the set
75  `a' are members of the set `b'.  It returns a boolean
76  array indicating whether or not the corresponding element of
77  `a' is a member of `b'.
78
79 NOTES
80  A set may either be an Array_Type or a List_Type object.
81  For a homogeneous collection of objects, it is better to
82  use an Array_Type. i.e., `[1,2,3]' instead of `{1,2,3}'.
83
84 SEE ALSO
85  complement, intersection, union, unique
86
87--------------------------------------------------------------
88
89union
90
91 SYNOPSIS
92  Form a set of the unique elements of one ore more subsets
93
94 USAGE
95  abc = union (a, b,..., c)
96
97 DESCRIPTION
98  This function interprets each of its arguments as a set, then merges
99  them together and returns only the unique elements.  The returned
100  value may either be an Array_Type or a List_Type
101  object.
102
103 NOTES
104  A set may either be an Array_Type or a List_Type object.
105  For a homogeneous collection of objects, it is better to
106  use an Array_Type. i.e., `[1,2,3]' instead of `{1,2,3}'.
107
108 SEE ALSO
109  complement, intersection, ismember, unique
110
111--------------------------------------------------------------
112
113unique
114
115 SYNOPSIS
116  Get the indices of the unique elements of a set
117
118 USAGE
119  indices = unique (A)
120
121 DESCRIPTION
122  This function returns an array of the indices of the unique elements
123  of a set.
124
125 NOTES
126  A set may either be an Array_Type or a List_Type object.
127  For a homogeneous collection of objects, it is better to
128  use an Array_Type. i.e., `[1,2,3]' instead of `{1,2,3}'.
129
130 SEE ALSO
131  complement, intersection, ismember, union
132
133--------------------------------------------------------------
134