javadoc.com.google.common.collect.ImmutableList.Builder.html Maven / Gradle / Ivy
The newest version!
ImmutableList.Builder (Guava: Google Core Libraries for Java 11.0.1 API)
Overview
Package
Class
Use
Tree
Deprecated
Index
Help
PREV CLASS
NEXT CLASS
FRAMES
NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD
DETAIL: FIELD | CONSTR | METHOD
com.google.common.collect
Class ImmutableList.Builder<E>
java.lang.Object
com.google.common.collect.ImmutableCollection.Builder<E>
com.google.common.collect.ImmutableList.Builder<E>
- Enclosing class:
- ImmutableList<E>
public static final class ImmutableList.Builder<E>
- extends ImmutableCollection.Builder<E>
A builder for creating immutable list instances, especially public
static final
lists ("constant lists"). Example:
public static final ImmutableList<Color> GOOGLE_COLORS
= new ImmutableList.Builder<Color>()
.addAll(WEBSAFE_COLORS)
.add(new Color(0, 191, 255))
.build();
Builder instances can be reused; it is safe to call build()
multiple
times to build multiple lists in series. Each new list contains all the
elements of the ones created before it.
- Since:
- 2.0 (imported from Google Collections Library)
Constructor Summary | |
---|---|
ImmutableList.Builder()
Creates a new builder. |
Method Summary | |
---|---|
ImmutableList.Builder<E> |
add(E... elements)
Adds each element of elements to the ImmutableList . |
ImmutableList.Builder<E> |
add(E element)
Adds element to the ImmutableList . |
ImmutableList.Builder<E> |
addAll(Iterable<? extends E> elements)
Adds each element of elements to the ImmutableList . |
ImmutableList.Builder<E> |
addAll(Iterator<? extends E> elements)
Adds each element of elements to the ImmutableList . |
ImmutableList<E> |
build()
Returns a newly-created ImmutableList based on the contents of
the Builder . |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
ImmutableList.Builder
public ImmutableList.Builder()
- Creates a new builder. The returned builder is equivalent to the builder
generated by
ImmutableList.builder()
.
Method Detail |
---|
add
public ImmutableList.Builder<E> add(E element)
- Adds
element
to theImmutableList
.- Specified by:
add
in classImmutableCollection.Builder<E>
- Parameters:
element
- the element to add- Returns:
- this
Builder
object - Throws:
NullPointerException
- ifelement
is null
addAll
public ImmutableList.Builder<E> addAll(Iterable<? extends E> elements)
- Adds each element of
elements
to theImmutableList
.- Overrides:
addAll
in classImmutableCollection.Builder<E>
- Parameters:
elements
- theIterable
to add to theImmutableList
- Returns:
- this
Builder
object - Throws:
NullPointerException
- ifelements
is null or contains a null element
add
public ImmutableList.Builder<E> add(E... elements)
- Adds each element of
elements
to theImmutableList
.- Overrides:
add
in classImmutableCollection.Builder<E>
- Parameters:
elements
- theIterable
to add to theImmutableList
- Returns:
- this
Builder
object - Throws:
NullPointerException
- ifelements
is null or contains a null element
addAll
public ImmutableList.Builder<E> addAll(Iterator<? extends E> elements)
- Adds each element of
elements
to theImmutableList
.- Overrides:
addAll
in classImmutableCollection.Builder<E>
- Parameters:
elements
- theIterable
to add to theImmutableList
- Returns:
- this
Builder
object - Throws:
NullPointerException
- ifelements
is null or contains a null element
build
public ImmutableList<E> build()
- Returns a newly-created
ImmutableList
based on the contents of theBuilder
.- Specified by:
build
in classImmutableCollection.Builder<E>
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2010-2012. All Rights Reserved.
© 2015 - 2025 Weber Informatics LLC | Privacy Policy