public static class ImmutableSortedMultiset.Builder<E> extends ImmutableMultiset.Builder<E>
public static final
multisets ("constant multisets"). Example:
public static final ImmutableSortedMultiset<Bean> BEANS =
new ImmutableSortedMultiset.Builder<Bean>(colorComparator())
.addCopies(Bean.COCOA, 4)
.addCopies(Bean.GARDEN, 6)
.addCopies(Bean.RED, 8)
.addCopies(Bean.BLACK_EYED, 10)
.build();
Builder instances can be reused; it is safe to call build()
multiple times to build
multiple multisets in series.
Constructor and Description |
---|
Builder(Comparator<? super E> comparator)
Creates a new builder.
|
Modifier and Type | Method and Description |
---|---|
ImmutableSortedMultiset.Builder<E> |
add(E... elements)
Adds each element of
elements to the ImmutableSortedMultiset . |
ImmutableSortedMultiset.Builder<E> |
add(E element)
Adds
element to the ImmutableSortedMultiset . |
ImmutableSortedMultiset.Builder<E> |
addAll(Iterable<? extends E> elements)
Adds each element of
elements to the ImmutableSortedMultiset . |
ImmutableSortedMultiset.Builder<E> |
addAll(Iterator<? extends E> elements)
Adds each element of
elements to the ImmutableSortedMultiset . |
ImmutableSortedMultiset.Builder<E> |
addCopies(E element,
int occurrences)
Adds a number of occurrences of an element to this
ImmutableSortedMultiset . |
ImmutableSortedMultiset<E> |
build()
Returns a newly-created
ImmutableSortedMultiset based on the contents of the Builder . |
ImmutableSortedMultiset.Builder<E> |
setCount(E element,
int count)
Adds or removes the necessary occurrences of an element such that the element attains the
desired count.
|
public Builder(Comparator<? super E> comparator)
ImmutableSortedMultiset.orderedBy(Comparator)
.@CanIgnoreReturnValue public ImmutableSortedMultiset.Builder<E> add(E element)
element
to the ImmutableSortedMultiset
.add
in class ImmutableMultiset.Builder<E>
element
- the element to addBuilder
objectNullPointerException
- if element
is null@CanIgnoreReturnValue public ImmutableSortedMultiset.Builder<E> add(E... elements)
elements
to the ImmutableSortedMultiset
.add
in class ImmutableMultiset.Builder<E>
elements
- the elements to addBuilder
objectNullPointerException
- if elements
is null or contains a null element@CanIgnoreReturnValue public ImmutableSortedMultiset.Builder<E> addCopies(E element, int occurrences)
ImmutableSortedMultiset
.addCopies
in class ImmutableMultiset.Builder<E>
element
- the element to addoccurrences
- the number of occurrences of the element to add. May be zero, in which
case no change will be made.Builder
objectNullPointerException
- if element
is nullIllegalArgumentException
- if occurrences
is negative, or if this operation
would result in more than Integer.MAX_VALUE
occurrences of the element@CanIgnoreReturnValue public ImmutableSortedMultiset.Builder<E> setCount(E element, int count)
setCount
in class ImmutableMultiset.Builder<E>
element
- the element to add or remove occurrences ofcount
- the desired count of the element in this multisetBuilder
objectNullPointerException
- if element
is nullIllegalArgumentException
- if count
is negative@CanIgnoreReturnValue public ImmutableSortedMultiset.Builder<E> addAll(Iterable<? extends E> elements)
elements
to the ImmutableSortedMultiset
.addAll
in class ImmutableMultiset.Builder<E>
elements
- the Iterable
to add to the ImmutableSortedMultiset
Builder
objectNullPointerException
- if elements
is null or contains a null element@CanIgnoreReturnValue public ImmutableSortedMultiset.Builder<E> addAll(Iterator<? extends E> elements)
elements
to the ImmutableSortedMultiset
.addAll
in class ImmutableMultiset.Builder<E>
elements
- the elements to add to the ImmutableSortedMultiset
Builder
objectNullPointerException
- if elements
is null or contains a null elementpublic ImmutableSortedMultiset<E> build()
ImmutableSortedMultiset
based on the contents of the Builder
.build
in class ImmutableMultiset.Builder<E>
Copyright © 2010–2019. All rights reserved.