java.lang.Object
java.util.AbstractCollection<E>
java.util.AbstractSet<E>
com.google.common.collect.Sets.SetView<E>
- All Implemented Interfaces:
Iterable<E>
,Collection<E>
,Set<E>
- Enclosing class:
Sets
An unmodifiable view of a set which may be backed by other sets; this view will change as the
backing sets do. Contains methods to copy the data into a new set which will then remain
stable. There is usually no reason to retain a reference of type
SetView
; typically,
you either use it as a plain Set
, or immediately invoke immutableCopy()
or
copyInto(S)
and forget the SetView
itself.- Since:
- 2.0
- Author:
- Kevin Bourrillion, Jared Levy, Chris Povirk
-
Method Summary
Modifier and TypeMethodDescriptionfinal boolean
Deprecated.Unsupported operation.final boolean
addAll
(Collection<? extends E> newElements) Deprecated.Unsupported operation.final void
clear()
Deprecated.Unsupported operation.copyInto
(S set) Copies the current contents of this set view into an existing set.Returns an immutable copy of the current contents of this set view.abstract UnmodifiableIterator
<E> iterator()
Scope the return type toUnmodifiableIterator
to ensure this is an unmodifiable view.final boolean
Deprecated.Unsupported operation.final boolean
removeAll
(Collection<?> oldElements) Deprecated.Unsupported operation.final boolean
Deprecated.Unsupported operation.final boolean
retainAll
(Collection<?> elementsToKeep) Deprecated.Unsupported operation.Methods inherited from class java.util.AbstractSet
equals, hashCode
Methods inherited from class java.util.AbstractCollection
contains, containsAll, isEmpty, size, toArray, toArray, toString
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface java.util.Collection
parallelStream, stream, toArray
Methods inherited from interface java.util.Set
contains, containsAll, isEmpty, size, spliterator, toArray, toArray
-
Method Details
-
immutableCopy
Returns an immutable copy of the current contents of this set view. Does not support null elements.Warning: this may have unexpected results if a backing set of this view uses a nonstandard notion of equivalence, for example if it is a
TreeSet
using a comparator that is inconsistent withObject.equals(Object)
. -
copyInto
Copies the current contents of this set view into an existing set. This method has equivalent behavior toset.addAll(this)
, assuming that all the sets involved are based on the same notion of equivalence.- Returns:
- a reference to
set
, for convenience
-
add
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified. -
remove
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified. -
addAll
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified. -
removeAll
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified. -
removeIf
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified.- Throws:
UnsupportedOperationException
- always
-
retainAll
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified. -
clear
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified. -
iterator
Scope the return type toUnmodifiableIterator
to ensure this is an unmodifiable view.- Specified by:
iterator
in interfaceCollection<E extends @Nullable Object>
- Specified by:
iterator
in interfaceIterable<E extends @Nullable Object>
- Specified by:
iterator
in interfaceSet<E extends @Nullable Object>
- Specified by:
iterator
in classAbstractCollection<E extends @Nullable Object>
- Since:
- 20.0 (present with return type
Iterator
since 2.0)
-