|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.google.common.collect.ImmutableCollection<E>
com.google.common.collect.ImmutableSet<E>
public abstract class ImmutableSet<E>
A high-performance, immutable Set
with reliable, user-specified
iteration order. Does not permit null elements.
Unlike Collections.unmodifiableSet(java.util.Set extends T>)
, which is a view of a
separate collection that can still change, an instance of this class contains
its own private data and will never change. This class is convenient
for public static final
sets ("constant sets") and also lets you
easily make a "defensive copy" of a set provided to your class by a caller.
Warning: Like most sets, an ImmutableSet
will not function
correctly if an element is modified after being placed in the set. For this
reason, and to avoid general confusion, it is strongly recommended to place
only immutable objects into this collection.
This class has been observed to perform significantly better than HashSet
for objects with very fast Object.hashCode()
implementations
(as a well-behaved immutable object should). While this class's factory
methods create hash-based instances, the ImmutableSortedSet
subclass
performs binary searches instead.
Note: Although this class is not final, it cannot be subclassed outside its package as it has no public or protected constructors. Thus, instances of this type are guaranteed to be immutable.
ImmutableList
,
ImmutableMap
,
Serialized FormMethod Summary | ||
---|---|---|
static
|
copyOf(Iterable<? extends E> elements)
Returns an immutable set containing the given elements, in order. |
|
static
|
copyOf(Iterator<? extends E> elements)
Returns an immutable set containing the given elements, in order. |
|
boolean |
equals(Object object)
|
|
int |
hashCode()
|
|
static
|
of()
Returns the empty immutable set. |
|
static
|
of(E... elements)
Returns an immutable set containing the given elements, in order. |
|
static
|
of(E element)
Returns an immutable set containing a single element. |
|
String |
toString()
|
Methods inherited from class com.google.common.collect.ImmutableCollection |
---|
add, addAll, clear, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface java.util.Set |
---|
add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray |
Method Detail |
---|
public static <E> ImmutableSet<E> of()
Collections.emptySet()
, and is preferable mainly for consistency
and maintainability of your code.
public static <E> ImmutableSet<E> of(E element)
Collections.singleton(T)
, but will not accept
a null element. It is preferable mainly for consistency and
maintainability of your code.
public static <E> ImmutableSet<E> of(E... elements)
Object.equals(java.lang.Object)
) after the
first are ignored (but too many of these may result in the set being
sized inappropriately).
NullPointerException
- if any of elements
is nullpublic static <E> ImmutableSet<E> copyOf(Iterable<? extends E> elements)
Object.equals(java.lang.Object)
) after the
first are ignored (but too many of these may result in the set being
sized inappropriately).
Note that if s
is a Set<String>
, then ImmutableSet.copyOf(s)
returns an ImmutableSet<String>
containing
each of the strings in s
, while ImmutableSet.of(s)
returns
a ImmutableSet<Set<String>>
containing one element (the given set
itself).
Note: Despite what the method name suggests, if elements
is an ImmutableSet
, no copy will actually be performed, and the
given set itself will be returned.
NullPointerException
- if any of elements
is nullpublic static <E> ImmutableSet<E> copyOf(Iterator<? extends E> elements)
Object.equals(java.lang.Object)
) after the
first are ignored.
NullPointerException
- if any of elements
is nullpublic boolean equals(Object object)
equals
in interface Collection<E>
equals
in interface Set<E>
equals
in class Object
public int hashCode()
hashCode
in interface Collection<E>
hashCode
in interface Set<E>
hashCode
in class Object
public String toString()
toString
in class ImmutableCollection<E>
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |