Package com.google.common.collect
Class ImmutableSortedSet.Builder<E>
java.lang.Object
com.google.common.collect.ImmutableCollection.Builder<E>
com.google.common.collect.ImmutableSet.Builder<E>
com.google.common.collect.ImmutableSortedSet.Builder<E>
- Enclosing class:
ImmutableSortedSet<E>
A builder for creating immutable sorted set instances, especially
public static final
sets ("constant sets"), with a given comparator. Example:
public static final ImmutableSortedSet<Number> LUCKY_NUMBERS =
new ImmutableSortedSet.Builder<Number>(ODDS_FIRST_COMPARATOR)
.addAll(SINGLE_DIGIT_PRIMES)
.add(42)
.build();
Builder instances can be reused; it is safe to call build() multiple times to build
multiple sets in series. Each set is a superset of the set created before it.
- Since:
- 2.0
-
Field Summary
FieldsFields inherited from class com.google.common.collect.ImmutableSet.Builder
forceCopyFields inherited from class com.google.common.collect.ImmutableCollection.Builder
DEFAULT_INITIAL_CAPACITY -
Constructor Summary
ConstructorsConstructorDescriptionBuilder(Comparator<? super E> comparator) Creates a new builder.Builder(Comparator<? super E> comparator, int expectedSize) Creates a new builder with an expected size. -
Method Summary
Modifier and TypeMethodDescriptionAddselementto theImmutableSortedSet.Adds each element ofelementsto theImmutableSortedSet, ignoring duplicate elements (only the first duplicate element is added).Adds each element ofelementsto theImmutableSortedSet, ignoring duplicate elements (only the first duplicate element is added).Adds each element ofelementsto theImmutableSortedSet, ignoring duplicate elements (only the first duplicate element is added).build()Returns a newly-createdImmutableSortedSetbased on the contents of theBuilderand its comparator.(package private) ImmutableSortedSet.Builder<E> combine(ImmutableSet.Builder<E> builder) (package private) voidcopy()private voidMethods inherited from class com.google.common.collect.ImmutableSet.Builder
copyIfNecessary, forceJdkMethods inherited from class com.google.common.collect.ImmutableCollection.Builder
expandedCapacity
-
Field Details
-
comparator
-
elements
-
n
private int n
-
-
Constructor Details
-
Builder
Creates a new builder. The returned builder is equivalent to the builder generated byImmutableSortedSet.orderedBy(java.util.Comparator<E>). -
Builder
Builder(Comparator<? super E> comparator, int expectedSize) Creates a new builder with an expected size.
-
-
Method Details
-
copy
void copy()- Overrides:
copyin classImmutableSet.Builder<E>
-
sortAndDedup
private void sortAndDedup() -
add
Addselementto theImmutableSortedSet. If theImmutableSortedSetalready containselement, thenaddhas no effect. (only the previously added element is retained).- Overrides:
addin classImmutableSet.Builder<E>- Parameters:
element- the element to add- Returns:
- this
Builderobject - Throws:
NullPointerException- ifelementis null
-
add
Adds each element ofelementsto theImmutableSortedSet, ignoring duplicate elements (only the first duplicate element is added).- Overrides:
addin classImmutableSet.Builder<E>- Parameters:
elements- the elements to add- Returns:
- this
Builderobject - Throws:
NullPointerException- ifelementscontains a null element
-
addAll
Adds each element ofelementsto theImmutableSortedSet, ignoring duplicate elements (only the first duplicate element is added).- Overrides:
addAllin classImmutableSet.Builder<E>- Parameters:
elements- the elements to add to theImmutableSortedSet- Returns:
- this
Builderobject - Throws:
NullPointerException- ifelementscontains a null element
-
addAll
Adds each element ofelementsto theImmutableSortedSet, ignoring duplicate elements (only the first duplicate element is added).- Overrides:
addAllin classImmutableSet.Builder<E>- Parameters:
elements- the elements to add to theImmutableSortedSet- Returns:
- this
Builderobject - Throws:
NullPointerException- ifelementscontains a null element
-
combine
- Overrides:
combinein classImmutableSet.Builder<E>
-
build
Returns a newly-createdImmutableSortedSetbased on the contents of theBuilderand its comparator.- Overrides:
buildin classImmutableSet.Builder<E>
-