added in API level 24

LongStream.Builder

public static interface LongStream.Builder
implements LongConsumer

java.util.stream.LongStream.Builder


A mutable builder for a LongStream.

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 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:

Summary

Public methods

abstract void accept(long t)

Adds an element to the stream being built.

default LongStream.Builder add(long t)

Adds an element to the stream being built.

abstract LongStream build()

Builds the stream, transitioning this builder to the built state.

Inherited methods

Public methods

accept

added in API level 24
void accept (long t)

Adds an element to the stream being built.

Parameters
t long: the input argument

Throws
IllegalStateException if the builder has already transitioned to the built state

add

added in API level 24
LongStream.Builder add (long t)

Adds an element to the stream being built.

Implementation Requirements:
  • The default implementation behaves as if:
    accept(t)
         return this;
     
Parameters
t long: the element to add

Returns
LongStream.Builder this builder

Throws
IllegalStateException if the builder has already transitioned to the built state

build

added in API level 24
LongStream 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
LongStream the built stream

Throws
IllegalStateException if the builder has already transitioned to the built state