class AbstractBasicCountingSet<T> extends java.lang.Object implements CountingSet<T>
Because it would be breaking the set semantics removal is not allowed.
All removal methods but clear()
therefore will throw an UnsupportedOperationException
.
Modifier and Type | Field and Description |
---|---|
protected java.util.function.Supplier<Counter> |
creator |
protected java.util.Map<T,Counter> |
map |
Constructor and Description |
---|
AbstractBasicCountingSet(java.util.Map<T,Counter> map,
java.util.function.Supplier<Counter> creator)
Constructor.
|
Modifier and Type | Method and Description |
---|---|
boolean |
add(T o)
Adds the specified element to this set if it is not already present
(optional operation).
|
boolean |
addAll(java.util.Collection<? extends T> c)
Adds all of the elements in the specified collection to this set if
they're not already present (optional operation).
|
void |
clear()
Removes all of the elements from this set (optional operation).
|
boolean |
contains(java.lang.Object o)
Returns true if this set contains the specified element.
|
boolean |
containsAll(java.util.Collection<?> c)
Returns true if this set contains all of the elements of the
specified collection.
|
int |
getCount(T item)
Get the count how often any item was added.
|
boolean |
isEmpty()
Returns true if this set contains no elements.
|
java.util.Iterator<T> |
iterator()
Returns an iterator over the elements in this set.
|
boolean |
remove(java.lang.Object o)
Removes the specified element from this set if it is present (optional
operation).
|
boolean |
removeAll(java.util.Collection<?> c)
Removes from this set all of its elements that are contained in the
specified collection (optional operation).
|
boolean |
retainAll(java.util.Collection<?> c)
Retains only the elements in this set that are contained in the
specified collection (optional operation).
|
int |
size()
Returns the number of elements in this set (its cardinality).
|
java.lang.Object[] |
toArray()
Returns an array containing all of the elements in this set.
|
<U> U[] |
toArray(U[] a)
Returns an array containing all of the elements in this set; the
runtime type of the returned array is that of the specified array.
|
public int size()
public boolean isEmpty()
public boolean contains(java.lang.Object o)
e
such that (o==null ? e==null : o.equals(e))
.contains
in interface java.util.Collection<T>
contains
in interface java.util.Set<T>
o
- element whose presence in this set is to be tested.java.lang.ClassCastException
- if the type of the specified element
is incompatible with this set (optional).java.lang.NullPointerException
- if the specified element is null and this
set does not support null elements (optional).@NotNull public java.util.Iterator<T> iterator()
@NotNull public java.lang.Object[] toArray()
@NotNull public <U> U[] toArray(@NotNull U[] a)
toArray
in interface java.util.Collection<T>
toArray
in interface java.util.Set<T>
a
- the array into which the elements of this set are to
be stored, if it is big enough; otherwise, a new array of the
same runtime type is allocated for this purpose.java.lang.ArrayStoreException
- the runtime type of a is not a supertype
of the runtime type of every element in this set.java.lang.NullPointerException
- if the specified array is null.public boolean add(T o)
o
, to this set if this set contains no element
e
such that (o==null ? e==null : o.equals(e))
.
If this set already contains the specified
element, the call leaves this set unchanged and returns false.
In combination with the restriction on constructors, this ensures that
sets never contain duplicate elements.The stipulation above does not imply that sets must accept all elements; sets may refuse to add any particular element, including null, and throwing an exception, as described in the specification for Collection.add. Individual set implementations should clearly document any restrictions on the elements that they may contain.
add
in interface java.util.Collection<T>
add
in interface java.util.Set<T>
o
- element to be added to this set.java.lang.UnsupportedOperationException
- if the add method is not
supported by this set.java.lang.ClassCastException
- if the class of the specified element
prevents it from being added to this set.java.lang.NullPointerException
- if the specified element is null and this
set does not support null elements.java.lang.IllegalArgumentException
- if some aspect of the specified element
prevents it from being added to this set.public boolean remove(java.lang.Object o)
This method will throw an UnsupportedOperationException
!
remove
in interface java.util.Collection<T>
remove
in interface java.util.Set<T>
o
- object to be removed from this set, if present.java.lang.ClassCastException
- if the type of the specified element
is incompatible with this set (optional).java.lang.NullPointerException
- if the specified element is null and this
set does not support null elements (optional).java.lang.UnsupportedOperationException
- if the remove method is
not supported by this set.public boolean containsAll(@NotNull java.util.Collection<?> c)
containsAll
in interface java.util.Collection<T>
containsAll
in interface java.util.Set<T>
c
- collection to be checked for containment in this set.java.lang.ClassCastException
- if the types of one or more elements
in the specified collection are incompatible with this
set (optional).java.lang.NullPointerException
- if the specified collection contains one
or more null elements and this set does not support null
elements (optional);
or if the specified collection is
null.contains(Object)
public boolean addAll(@NotNull java.util.Collection<? extends T> c)
addAll
in interface java.util.Collection<T>
addAll
in interface java.util.Set<T>
c
- collection whose elements are to be added to this set.java.lang.UnsupportedOperationException
- if the addAll method is
not supported by this set.java.lang.ClassCastException
- if the class of some element of the
specified collection prevents it from being added to this
set.java.lang.NullPointerException
- if the specified collection contains one
or more null elements and this set does not support null
elements, or if the specified collection is null.java.lang.IllegalArgumentException
- if some aspect of some element of the
specified collection prevents it from being added to this
set.add(Object)
public boolean retainAll(@NotNull java.util.Collection<?> c)
This method will throw an UnsupportedOperationException
!
retainAll
in interface java.util.Collection<T>
retainAll
in interface java.util.Set<T>
c
- collection that defines which elements this set will retain.java.lang.UnsupportedOperationException
- if the retainAll method
is not supported by this Collection.java.lang.ClassCastException
- if the types of one or more elements in this
set are incompatible with the specified collection
(optional).java.lang.NullPointerException
- if this set contains a null element and
the specified collection does not support null elements
(optional);
or if the specified collection is
null.remove(Object)
public boolean removeAll(@NotNull java.util.Collection<?> c)
This method will throw an UnsupportedOperationException
!
removeAll
in interface java.util.Collection<T>
removeAll
in interface java.util.Set<T>
c
- collection that defines which elements will be removed from
this set.java.lang.UnsupportedOperationException
- if the removeAll
method is not supported by this Collection.java.lang.ClassCastException
- if the types of one or more elements in this
set are incompatible with the specified collection
(optional).java.lang.NullPointerException
- if this set contains a null element and
the specified collection does not support null elements
(optional);
or if the specified collection is
null.remove(Object)
public void clear()
public int getCount(T item)
getCount
in interface CountingSet<T>
item
- item to look for0
if the item was never added
(or the clear code has been used after its addition)