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