Class: Set
Overview
Portions Copyright (c) 2002-2013 Akinori MUSHA [email protected]
Class Method Summary collapse
Instance Method Summary collapse
- #-(enum) ⇒ Object (also: #difference)
- #==(other) ⇒ Object
- #add(o) ⇒ Object (also: #<<)
- #add?(o) ⇒ Boolean
- #classify(&block) ⇒ Object
- #clear ⇒ Object
- #collect!(&block) ⇒ Object (also: #map!)
- #delete(o) ⇒ Object
- #delete?(o) ⇒ Boolean
- #delete_if ⇒ Object
- #disjoint?(set) ⇒ Boolean
- #dup ⇒ Object
- #each(&block) ⇒ Object
- #empty? ⇒ Boolean
- #eql?(other) ⇒ Boolean
- #include?(o) ⇒ Boolean (also: #member?)
-
#initialize(enum = nil, &block) ⇒ Set
constructor
A new instance of Set.
- #inspect ⇒ Object
- #intersect?(set) ⇒ Boolean
- #keep_if ⇒ Object
- #merge(enum) ⇒ Object
- #proper_subset?(set) ⇒ Boolean (also: #<)
- #proper_superset?(set) ⇒ Boolean (also: #>)
- #reject!(&block) ⇒ Object
- #replace(enum) ⇒ Object
- #select!(&block) ⇒ Object (also: #filter!)
- #size ⇒ Object (also: #length)
- #subset?(set) ⇒ Boolean (also: #<=)
- #subtract(enum) ⇒ Object
- #superset?(set) ⇒ Boolean (also: #>=)
- #to_a ⇒ Object
- #|(enum) ⇒ Object (also: #+, #union)
Methods included from Enumerable
#each_async , #to_json , #to_set
Constructor Details
#initialize(enum = nil, &block) ⇒ Set
Returns a new instance of Set.
9 10 11 12 13 14 15 16 17 18 19 20
# File 'opal/stdlib/set.rb', line 9 def initialize(enum = nil, &block) @hash = {} return if enum.nil? ::Kernel .raise ::ArgumentError, 'value must be enumerable' unless ::Enumerable === enum if block enum.each { |item| add yield(item) } else merge(enum) end end
Class Method Details
.[](*ary) ⇒ Object
5 6 7
# File 'opal/stdlib/set.rb', line 5 def self.[](*ary) new(ary) end
Instance Method Details
#-(enum) ⇒ Object Also known as: difference
27 28 29 30 31 32 33
# File 'opal/stdlib/set.rb', line 27 def -(enum) unless enum.respond_to? :each ::Kernel .raise ::ArgumentError, 'value must be enumerable' end dup.subtract(enum) end
#==(other) ⇒ Object
39 40 41 42 43 44 45 46 47 48 49
# File 'opal/stdlib/set.rb', line 39 def ==(other) if equal?(other) true elsif other.instance_of?(self.class) @hash == other.instance_variable_get(:@hash) elsif other.is_a?(::Set ) && size == other.size other.all? { |o| @hash.include?(o) } else false end end
#add(o) ⇒ Object Also known as: <<
51 52 53 54
# File 'opal/stdlib/set.rb', line 51 def add(o) @hash[o] = true self end
#add?(o) ⇒ Boolean
Returns:
- (Boolean )
113 114 115 116 117 118 119
# File 'opal/stdlib/set.rb', line 113 def add?(o) if include?(o) nil else add(o) end end
#classify(&block) ⇒ Object
#clear ⇒ Object
135 136 137 138
# File 'opal/stdlib/set.rb', line 135 def clear @hash.clear self end
#collect!(&block) ⇒ Object Also known as: map!
66 67 68 69 70 71
# File 'opal/stdlib/set.rb', line 66 def collect!(&block) return enum_for(:collect!) unless block_given? result = self.class.new each { |item| result << yield(item) } replace result end
#delete(o) ⇒ Object
73 74 75 76
# File 'opal/stdlib/set.rb', line 73 def delete(o) @hash.delete(o) self end
#delete?(o) ⇒ Boolean
Returns:
- (Boolean )
78 79 80 81 82 83
# File 'opal/stdlib/set.rb', line 78 def delete?(o) if include?(o) delete(o) self end end
#delete_if ⇒ Object
85 86 87 88 89 90 91
# File 'opal/stdlib/set.rb', line 85 def delete_if return enum_for(:delete_if) unless block_given? # @hash.delete_if should be faster, but using it breaks the order # of enumeration in subclasses. select { |o| yield o }.each { |o| @hash.delete(o) } self end
#disjoint?(set) ⇒ Boolean
Returns:
- (Boolean )
211 212 213
# File 'opal/stdlib/set.rb', line 211 def disjoint?(set) !intersect?(set) end
#dup ⇒ Object
22 23 24 25
# File 'opal/stdlib/set.rb', line 22 def dup result = self.class.new result.merge(self) end
#each(&block) ⇒ Object
121 122 123 124 125
# File 'opal/stdlib/set.rb', line 121 def each(&block) return enum_for(:each) unless block_given? @hash.each_key(&block) self end
#empty? ⇒ Boolean
Returns:
- (Boolean )
127 128 129
# File 'opal/stdlib/set.rb', line 127 def empty? @hash.empty? end
#eql?(other) ⇒ Boolean
Returns:
- (Boolean )
131 132 133
# File 'opal/stdlib/set.rb', line 131 def eql?(other) @hash.eql?(other.instance_eval { @hash }) end
#include?(o) ⇒ Boolean Also known as: member?
Returns:
- (Boolean )
140 141 142
# File 'opal/stdlib/set.rb', line 140 def include?(o) @hash.include?(o) end
#inspect ⇒ Object
35 36 37
# File 'opal/stdlib/set.rb', line 35 def inspect "#<Set: {#{to_a.join(',')}}>" end
#intersect?(set) ⇒ Boolean
Returns:
- (Boolean )
202 203 204 205 206 207 208 209
# File 'opal/stdlib/set.rb', line 202 def intersect?(set) `is_set(set)` if size < set.size any? { |o| set.include?(o) } else set.any? { |o| include?(o) } end end
#keep_if ⇒ Object
93 94 95 96 97
# File 'opal/stdlib/set.rb', line 93 def keep_if return enum_for(:keep_if) unless block_given? reject { |o| yield o }.each { |o| @hash.delete(o) } self end
#merge(enum) ⇒ Object
144 145 146 147
# File 'opal/stdlib/set.rb', line 144 def merge(enum) enum.each { |item| add item } self end
#proper_subset?(set) ⇒ Boolean Also known as: <
Returns:
- (Boolean )
196 197 198 199 200
# File 'opal/stdlib/set.rb', line 196 def proper_subset?(set) `is_set(set)` return false if set.size <= size all? { |o| set.include?(o) } end
#proper_superset?(set) ⇒ Boolean Also known as: >
Returns:
- (Boolean )
184 185 186 187 188
# File 'opal/stdlib/set.rb', line 184 def proper_superset?(set) `is_set(set)` return false if size <= set.size set.all? { |o| include?(o) } end
#reject!(&block) ⇒ Object
99 100 101 102 103 104
# File 'opal/stdlib/set.rb', line 99 def reject!(&block) return enum_for(:reject!) unless block_given? before = size delete_if(&block) size == before ? nil : self end
#replace(enum) ⇒ Object
149 150 151 152 153 154
# File 'opal/stdlib/set.rb', line 149 def replace(enum) clear merge(enum) self end
#select!(&block) ⇒ Object Also known as: filter!
106 107 108 109 110 111
# File 'opal/stdlib/set.rb', line 106 def select!(&block) return enum_for(:select!) unless block_given? before = size keep_if(&block) size == before ? nil : self end
#size ⇒ Object Also known as: length
156 157 158
# File 'opal/stdlib/set.rb', line 156 def size @hash.size end
#subset?(set) ⇒ Boolean Also known as: <=
Returns:
- (Boolean )
190 191 192 193 194
# File 'opal/stdlib/set.rb', line 190 def subset?(set) `is_set(set)` return false if set.size < size all? { |o| set.include?(o) } end
#subtract(enum) ⇒ Object
160 161 162 163
# File 'opal/stdlib/set.rb', line 160 def subtract(enum) enum.each { |item| delete item } self end
#superset?(set) ⇒ Boolean Also known as: >=
Returns:
- (Boolean )
178 179 180 181 182
# File 'opal/stdlib/set.rb', line 178 def superset?(set) `is_set(set)` return false if size < set.size set.all? { |o| include?(o) } end
#to_a ⇒ Object
215 216 217
# File 'opal/stdlib/set.rb', line 215 def to_a @hash.keys end