IntStream.Builder

AI-generated Key Takeaways

• IntStream.Builder allows you to create an IntStream by adding elements individually.

• It has two phases: a building phase where you can add elements, and a built phase after calling build(), creating the IntStream.

• accept(int) and add(int) methods add elements to the builder during the building phase.

• build() creates the IntStream from the added elements and transitions the builder to the built state, preventing further modifications.

• Attempting to modify the builder after calling build() results in an IllegalStateException.

public static interface IntStream.Builder implements IntConsumer

A mutable builder for an IntStream.

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.

See Also

• IntStream.builder()

Public Method Summary

abstract void	accept(int t) Adds an element to the stream being built.
IntStream.Builder	add(int t) Adds an element to the stream being built.
abstract IntStream	build() Builds the stream, transitioning this builder to the built state.

Inherited Method Summary

From interface java.util.function.IntConsumer

abstract void	accept(int value) Performs this operation on the given argument.
IntConsumer	andThen(IntConsumer after) Returns a composed IntConsumer that performs, in sequence, this operation followed by the after operation.

Public Methods

public abstract void accept (int t)

Adds an element to the stream being built.

Parameters

t	the input argument

Throws

IllegalStateException	if the builder has already transitioned to the built state

public IntStream.Builder add (int t)

Adds an element to the stream being built.

Parameters

t	the element to add

Returns

• this builder

Throws

IllegalStateException	if the builder has already transitioned to the built state

public abstract IntStream build ()

Builds the stream, transitioning this builder to the built state. An IllegalStateException 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