Constructor and Description |
---|
MultiDimensionalSet(java.util.Set<Pair<K,V>> backedSet) |
Modifier and Type | Method and Description |
---|---|
void |
add(K k,
V v) |
boolean |
add(Pair<K,V> kvPair)
Adds the specified element to this applyTransformToDestination if it is not already present
(optional operation).
|
boolean |
addAll(java.util.Collection<? extends Pair<K,V>> c)
Adds all of the elements in the specified collection to this applyTransformToDestination if
they're not already present (optional operation).
|
void |
clear()
Removes all of the elements from this applyTransformToDestination (optional operation).
|
static <K,V> MultiDimensionalSet<K,V> |
concurrentSkipListSet() |
boolean |
contains(K k,
V v) |
boolean |
contains(java.lang.Object o)
Returns true if this applyTransformToDestination contains the specified element.
|
boolean |
containsAll(java.util.Collection<?> c)
Returns true if this applyTransformToDestination contains all of the elements of the
specified collection.
|
static <K,V> MultiDimensionalSet<K,V> |
hashSet() |
boolean |
isEmpty()
Returns true if this applyTransformToDestination contains no elements.
|
java.util.Iterator<Pair<K,V>> |
iterator()
Returns an iterator over the elements in this applyTransformToDestination.
|
boolean |
remove(java.lang.Object o)
Removes the specified element from this applyTransformToDestination if it is present
(optional operation).
|
boolean |
removeAll(java.util.Collection<?> c)
Removes from this applyTransformToDestination 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 applyTransformToDestination that are contained in the
specified collection (optional operation).
|
int |
size()
Returns the number of elements in this applyTransformToDestination (its cardinality).
|
java.lang.Object[] |
toArray()
Returns an array containing all of the elements in this applyTransformToDestination.
|
<T> T[] |
toArray(T[] a)
Returns an array containing all of the elements in this applyTransformToDestination; the
runtime type of the returned array is that of the specified array.
|
static <K,V> MultiDimensionalSet<K,V> |
treeSet() |
public static <K,V> MultiDimensionalSet<K,V> hashSet()
public static <K,V> MultiDimensionalSet<K,V> treeSet()
public static <K,V> MultiDimensionalSet<K,V> concurrentSkipListSet()
public int size()
public boolean isEmpty()
public boolean contains(java.lang.Object o)
contains
in interface java.util.Collection<Pair<K,V>>
contains
in interface java.util.Set<Pair<K,V>>
o
- element whose presence in this applyTransformToDestination is to be testedjava.lang.ClassCastException
- if the type of the specified element
is incompatible with this applyTransformToDestination
(optional)java.lang.NullPointerException
- if the specified element is null and this
applyTransformToDestination does not permit null elements
(optional)public java.util.Iterator<Pair<K,V>> iterator()
public java.lang.Object[] toArray()
The returned array will be "safe" in that no references to it are maintained by this applyTransformToDestination. (In other words, this method must allocate a new array even if this applyTransformToDestination is backed by an array). The caller is thus free to modify the returned array.
This method acts as bridge between array-based and collection-based APIs.
public <T> T[] toArray(T[] a)
If this applyTransformToDestination fits in the specified array with room to spare (i.e., the array has more elements than this applyTransformToDestination), the element in the array immediately following the end of the applyTransformToDestination is applyTransformToDestination to null. (This is useful in determining the length of this applyTransformToDestination only if the caller knows that this applyTransformToDestination does not contain any null elements.)
If this applyTransformToDestination makes any guarantees as to what order its elements are returned by its iterator, this method must return the elements in the same order.
Like the toArray()
method, this method acts as bridge between
array-based and collection-based APIs. Further, this method allows
precise control over the runtime type of the output array, and may,
under certain circumstances, be used to save allocation costs.
Suppose x is a applyTransformToDestination known to contain only strings. The following code can be used to dump the applyTransformToDestination into a newly allocated array of String:
String[] y = x.toArray(new String[0]);Note that toArray(new Object[0]) is identical in function to toArray().
toArray
in interface java.util.Collection<Pair<K,V>>
toArray
in interface java.util.Set<Pair<K,V>>
a
- the array into which the elements of this applyTransformToDestination 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
- if the runtime type of the specified array
is not a supertype of the runtime type of every element in this
applyTransformToDestinationjava.lang.NullPointerException
- if the specified array is nullpublic boolean add(Pair<K,V> kvPair)
The stipulation above does not imply that sets must accept all
elements; sets may refuse to add any particular element, including
null, and throw an exception, as described in the
specification for Collection.add
.
Individual applyTransformToDestination implementations should clearly document any
restrictions on the elements that they may contain.
add
in interface java.util.Collection<Pair<K,V>>
add
in interface java.util.Set<Pair<K,V>>
kvPair
- element to be added to this applyTransformToDestinationjava.lang.UnsupportedOperationException
- if the add operation
is not supported by this applyTransformToDestinationjava.lang.ClassCastException
- if the class of the specified element
prevents it from being added to this applyTransformToDestinationjava.lang.NullPointerException
- if the specified element is null and this
applyTransformToDestination does not permit null elementsjava.lang.IllegalArgumentException
- if some property of the specified element
prevents it from being added to this applyTransformToDestinationpublic boolean remove(java.lang.Object o)
remove
in interface java.util.Collection<Pair<K,V>>
remove
in interface java.util.Set<Pair<K,V>>
o
- object to be removed from this applyTransformToDestination, if presentjava.lang.ClassCastException
- if the type of the specified element
is incompatible with this applyTransformToDestination
(optional)java.lang.NullPointerException
- if the specified element is null and this
applyTransformToDestination does not permit null elements
(optional)java.lang.UnsupportedOperationException
- if the remove operation
is not supported by this applyTransformToDestinationpublic boolean containsAll(java.util.Collection<?> c)
containsAll
in interface java.util.Collection<Pair<K,V>>
containsAll
in interface java.util.Set<Pair<K,V>>
c
- collection to be checked for containment in this applyTransformToDestinationjava.lang.ClassCastException
- if the types of one or more elements
in the specified collection are incompatible with this
applyTransformToDestination
(optional)java.lang.NullPointerException
- if the specified collection contains one
or more null elements and this applyTransformToDestination does not permit null
elements
(optional),
or if the specified collection is nullcontains(Object)
public boolean addAll(java.util.Collection<? extends Pair<K,V>> c)
addAll
in interface java.util.Collection<Pair<K,V>>
addAll
in interface java.util.Set<Pair<K,V>>
c
- collection containing elements to be added to this applyTransformToDestinationjava.lang.UnsupportedOperationException
- if the addAll operation
is not supported by this applyTransformToDestinationjava.lang.ClassCastException
- if the class of an element of the
specified collection prevents it from being added to this applyTransformToDestinationjava.lang.NullPointerException
- if the specified collection contains one
or more null elements and this applyTransformToDestination does not permit null
elements, or if the specified collection is nulljava.lang.IllegalArgumentException
- if some property of an element of the
specified collection prevents it from being added to this applyTransformToDestinationSet.add(Object)
public boolean retainAll(java.util.Collection<?> c)
retainAll
in interface java.util.Collection<Pair<K,V>>
retainAll
in interface java.util.Set<Pair<K,V>>
c
- collection containing elements to be retained in this applyTransformToDestinationjava.lang.UnsupportedOperationException
- if the retainAll operation
is not supported by this applyTransformToDestinationjava.lang.ClassCastException
- if the class of an element of this applyTransformToDestination
is incompatible with the specified collection
(optional)java.lang.NullPointerException
- if this applyTransformToDestination contains a null element and the
specified collection does not permit null elements
(optional),
or if the specified collection is nullremove(Object)
public boolean removeAll(java.util.Collection<?> c)
removeAll
in interface java.util.Collection<Pair<K,V>>
removeAll
in interface java.util.Set<Pair<K,V>>
c
- collection containing elements to be removed from this applyTransformToDestinationjava.lang.UnsupportedOperationException
- if the removeAll operation
is not supported by this applyTransformToDestinationjava.lang.ClassCastException
- if the class of an element of this applyTransformToDestination
is incompatible with the specified collection
(optional)java.lang.NullPointerException
- if this applyTransformToDestination contains a null element and the
specified collection does not permit null elements
(optional),
or if the specified collection is nullremove(Object)
,
contains(Object)
public void clear()