T
- the type of stream elementsConsumer<T>
public static interface Stream.Builder<T> extends Consumer<T>
Stream
. This allows the creation of a Stream
by generating elements individually and adding them to the Builder
(without the copying overhead that comes from using an ArrayList
as a temporary buffer.) 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.
void accept(T t)
accept
in interface Consumer<T>
t
- the input argumentIllegalStateException
- if the builder has already transitioned to the built statedefault Stream.Builder<T> add(T t)
accept(t)
return this;
t
- the element to addthis
builderIllegalStateException
- if the builder has already transitioned to the built stateStream<T> build()
IllegalStateException
is thrown if there are further attempts to operate on the builder after it has entered the built state.IllegalStateException
- if the builder has already transitioned to the built state
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/stream/Stream.Builder.html