Package com.google.common.collect
Class Sets.SetView<E>
- java.lang.Object
-
- java.util.AbstractCollection<E>
-
- java.util.AbstractSet<E>
-
- com.google.common.collect.Sets.SetView<E>
-
- All Implemented Interfaces:
java.lang.Iterable<E>
,java.util.Collection<E>
,java.util.Set<E>
- Enclosing class:
- Sets
public abstract static class Sets.SetView<E> extends java.util.AbstractSet<E>
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 typeSetView
; typically, you either use it as a plainSet
, or immediately invokeimmutableCopy()
orcopyInto(S)
and forget theSetView
itself.- Since:
- 2.0
-
-
Constructor Summary
Constructors Modifier Constructor Description private
SetView()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods Modifier and Type Method Description boolean
add(E e)
Deprecated.Unsupported operation.boolean
addAll(java.util.Collection<? extends E> newElements)
Deprecated.Unsupported operation.void
clear()
Deprecated.Unsupported operation.<S extends java.util.Set<E>>
ScopyInto(S set)
Copies the current contents of this set view into an existing set.ImmutableSet<E>
immutableCopy()
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.boolean
remove(java.lang.Object object)
Deprecated.Unsupported operation.boolean
removeAll(java.util.Collection<?> oldElements)
Deprecated.Unsupported operation.boolean
removeIf(java.util.function.Predicate<? super E> filter)
Deprecated.Unsupported operation.boolean
retainAll(java.util.Collection<?> elementsToKeep)
Deprecated.Unsupported operation.-
Methods inherited from class java.util.AbstractCollection
contains, containsAll, isEmpty, size, toArray, toArray, toString
-
-
-
-
Method Detail
-
immutableCopy
public ImmutableSet<E> 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
public <S extends java.util.Set<E>> S copyInto(S set)
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 public final boolean add(E e)
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified.
-
remove
@Deprecated public final boolean remove(java.lang.Object object)
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified.
-
addAll
@Deprecated public final boolean addAll(java.util.Collection<? extends E> newElements)
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified.
-
removeAll
@Deprecated public final boolean removeAll(java.util.Collection<?> oldElements)
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified.
-
removeIf
@Deprecated public final boolean removeIf(java.util.function.Predicate<? super E> filter)
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified.- Throws:
java.lang.UnsupportedOperationException
- always
-
retainAll
@Deprecated public final boolean retainAll(java.util.Collection<?> elementsToKeep)
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified.
-
clear
@Deprecated public final void clear()
Deprecated.Unsupported operation.Guaranteed to throw an exception and leave the collection unmodified.
-
iterator
public abstract UnmodifiableIterator<E> iterator()
Scope the return type toUnmodifiableIterator
to ensure this is an unmodifiable view.
-
-