Interface IntStream.Builder
-
- All Superinterfaces:
- IntConsumer
- Enclosing interface:
- IntStream
public static interface IntStream.Builder extends IntConsumer
A mutable builder for anIntStream
.A stream builder has a lifecycle, which starts in a building phase, during which elements can be added, and then transitions to a built phase, after which elements may not be added. The built phase begins when the
build()
method is called, which creates an ordered stream whose elements are the elements that were added to the stream builder, in the order they were added.- Since:
- 1.8
- See Also:
-
IntStream.builder()
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method and Description void
accept(int t)
Adds an element to the stream being built.default IntStream.Builder
add(int t)
Adds an element to the stream being built.IntStream
build()
Builds the stream, transitioning this builder to the built state.-
Methods inherited from interface java.util.function.IntConsumer
andThen
-
-
-
-
Method Detail
accept
void accept(int t)
Adds an element to the stream being built.- Specified by:
-
accept
in interfaceIntConsumer
- Parameters:
-
t
- the input argument - Throws:
-
IllegalStateException
- if the builder has already transitioned to the built state
add
default IntStream.Builder add(int t)
Adds an element to the stream being built.- Implementation Requirements:
-
The default implementation behaves as if:
accept(t) return this;
- Parameters:
-
t
- the element to add - Returns:
-
this
builder - Throws:
-
IllegalStateException
- if the builder has already transitioned to the built state
build
IntStream build()
Builds the stream, transitioning this builder to the built state. AnIllegalStateException
is thrown if there are further attempts to operate on the builder after it has entered the built state.- Returns:
- the built stream
- Throws:
-
IllegalStateException
- if the builder has already transitioned to the built state
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.