ParallelLongStreamSupport (Parallel Stream Support 1.0.1 API)

java.lang.Object
- com.github.ferstl.streams.ParallelLongStreamSupport

All Implemented Interfaces:

AutoCloseable, BaseStream<Long,LongStream>, LongStream
```
public class ParallelLongStreamSupport
extends Object
implements LongStream
```
An implementation of LongStream which uses a custom ForkJoinPool for parallel aggregate operations. This is the long primitive specialization of ParallelStreamSupport.
The following example illustrates an aggregate operation using ParallelStreamSupport and ParallelLongStreamSupport with a custom ForkJoinPool, computing the sum of the weights of the red widgets:
```
 ForkJoinPool pool = new ForkJoinPool();
 long sum = ParallelStreamSupport.parallelStream(widgets, pool)
     .filter(w -> w.getColor() == RED)
     .mapToLong(w -> w.getWeight())
     .sum();
 
```
In case this stream is configured for parallel execution, i.e. isParallel() returns true, a terminal operation will be executed as ForkJoinTask in the custom ForkJoinPool. Otherwise it will be executed in the calling thread.
This implementation offers various factory methods which are based on:
- The static factory methods of LongStream, which are meaningful for parallel streams
- Arrays.stream(long[])
- StreamSupport.longStream(Spliterator.OfLong, boolean)
- StreamSupport.longStream(Supplier, int, boolean)
API Note:

Internally, this stream wraps a long stream which is initially created in one of the static factory methods. Whenever a non-terminal operation is called the underlying stream will be replaced with the result of calling the same method on that stream. The return value of these operations is always this stream or, in case of operations that return a different type of stream, one of ParallelStreamSupport, ParallelIntStreamSupport or ParallelDoubleStreamSupport.

Although each factory method returns a parallel stream, calling sequential() is still possible and leads to sequential execution of a terminal operation within the calling thread.

Implementation Note:

See the class documentation for Stream and the package documentation for java.util.stream for additional specification.

Nested Class Summary
- Nested classes/interfaces inherited from interface java.util.stream.LongStream
  LongStream.Builder

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`allMatch(LongPredicate predicate)` Returns whether all elements of this stream match the provided predicate.
`boolean`	`anyMatch(LongPredicate predicate)` Returns whether any elements of this stream match the provided predicate.
`DoubleStream`	`asDoubleStream()` Returns a `DoubleStream` consisting of the elements of this stream, converted to `double`.
`OptionalDouble`	`average()` Returns an `OptionalDouble` describing the arithmetic mean of elements of this stream, or an empty optional if this stream is empty.
`Stream<Long>`	`boxed()` Returns a `Stream` consisting of the elements of this stream, each boxed to a `Long`.
`void`	`close()` Closes this stream, causing all close handlers for this stream pipeline to be called.
`<R> R`	`collect(Supplier<R> supplier, ObjLongConsumer<R> accumulator, BiConsumer<R,R> combiner)` Performs a mutable reduction operation on the elements of this stream.
`static LongStream`	`concat(LongStream a, LongStream b, ForkJoinPool workerPool)` Creates a lazily concatenated parallel `long` stream whose elements are all the elements of the first stream followed by all the elements of the second stream.
`long`	`count()` Returns the count of elements in this stream.
`LongStream`	`distinct()` Returns a stream consisting of the distinct elements of this stream.
`protected <R> R`	`execute(Callable<R> terminalOperation)`
`protected void`	`execute(Runnable terminalOperation)`
`LongStream`	`filter(LongPredicate predicate)` Returns a stream consisting of the elements of this stream that match the given predicate.
`OptionalLong`	`findAny()` Returns an `OptionalLong` describing some element of the stream, or an empty `OptionalLong` if the stream is empty.
`OptionalLong`	`findFirst()` Returns an `OptionalLong` describing the first element of this stream, or an empty `OptionalLong` if the stream is empty.
`LongStream`	`flatMap(LongFunction<? extends LongStream> mapper)` Returns a stream consisting of the results of replacing each element of this stream with the contents of a mapped stream produced by applying the provided mapping function to each element.
`void`	`forEach(LongConsumer action)` Performs an action for each element of this stream.
`void`	`forEachOrdered(LongConsumer action)` Performs an action for each element of this stream, guaranteeing that each element is processed in encounter order for streams that have a defined encounter order.
`static LongStream`	`generate(LongSupplier supplier, ForkJoinPool workerPool)` Creates a parallel infinite sequential unordered `long` stream where each element is generated by the provided `LongSupplier`.
`boolean`	`isParallel()` Returns whether this stream, if a terminal operation were to be executed, would execute in parallel.
`static LongStream`	`iterate(long seed, LongUnaryOperator operator, ForkJoinPool workerPool)` Creates a parallel infinite ordered `long` stream produced by iterative application of a function `f` to an initial element `seed`.
`PrimitiveIterator.OfLong`	`iterator()` Returns an iterator for the elements of this stream.
`LongStream`	`limit(long maxSize)` Returns a stream consisting of the elements of this stream, truncated to be no longer than `maxSize` in length.
`LongStream`	`map(LongUnaryOperator mapper)` Returns a stream consisting of the results of applying the given function to the elements of this stream.
`DoubleStream`	`mapToDouble(LongToDoubleFunction mapper)` Returns a `DoubleStream` consisting of the results of applying the given function to the elements of this stream.
`IntStream`	`mapToInt(LongToIntFunction mapper)` Returns an `IntStream` consisting of the results of applying the given function to the elements of this stream.
`<U> Stream<U>`	`mapToObj(LongFunction<? extends U> mapper)` Returns an object-valued `Stream` consisting of the results of applying the given function to the elements of this stream.
`OptionalLong`	`max()` Returns an `OptionalLong` describing the maximum element of this stream, or an empty optional if this stream is empty.
`OptionalLong`	`min()` Returns an `OptionalLong` describing the minimum element of this stream, or an empty optional if this stream is empty.
`boolean`	`noneMatch(LongPredicate predicate)` Returns whether no elements of this stream match the provided predicate.
`S`	`onClose(Runnable closeHandler)` Returns an equivalent stream with an additional close handler.
`S`	`parallel()` Returns an equivalent stream that is parallel.
`static LongStream`	`parallelStream(long[] array, ForkJoinPool workerPool)` Creates a parallel `long` stream from the given Array.
`static LongStream`	`parallelStream(LongStream.Builder builder, ForkJoinPool workerPool)` Creates a parallel `long` stream from the given `Builder`.
`static LongStream`	`parallelStream(Spliterator.OfLong spliterator, ForkJoinPool workerPool)` Creates a parallel `long` stream from the given Spliterator.
`static LongStream`	`parallelStream(Supplier<? extends Spliterator.OfLong> supplier, int characteristics, ForkJoinPool workerPool)` Creates a parallel `long` stream from the given Spliterator supplier.
`LongStream`	`peek(LongConsumer action)` Returns a stream consisting of the elements of this stream, additionally performing the provided action on each element as elements are consumed from the resulting stream.
`static LongStream`	`range(long startInclusive, long endExclusive, ForkJoinPool workerPool)` Creates a parallel ordered `long` stream from `startInclusive` (inclusive) to `endExclusive` (exclusive) by an incremental step of `1`.
`static LongStream`	`rangeClosed(long startInclusive, long endInclusive, ForkJoinPool workerPool)` Creates a parallel ordered `long` stream from `startInclusive` (inclusive) to `endInclusive` (inclusive) by an incremental step of `1`.
`OptionalLong`	`reduce(LongBinaryOperator op)` Performs a reduction on the elements of this stream, using an associative accumulation function, and returns an `OptionalLong` describing the reduced value, if any.
`long`	`reduce(long identity, LongBinaryOperator op)` Performs a reduction on the elements of this stream, using the provided identity value and an associative accumulation function, and returns the reduced value.
`S`	`sequential()` Returns an equivalent stream that is sequential.
`LongStream`	`skip(long n)` Returns a stream consisting of the remaining elements of this stream after discarding the first `n` elements of the stream.
`LongStream`	`sorted()` Returns a stream consisting of the elements of this stream in sorted order.
`Spliterator.OfLong`	`spliterator()` Returns a spliterator for the elements of this stream.
`long`	`sum()` Returns the sum of elements in this stream.
`LongSummaryStatistics`	`summaryStatistics()` Returns a `LongSummaryStatistics` describing various summary data about the elements of this stream.
`long[]`	`toArray()` Returns an array containing the elements of this stream.
`S`	`unordered()` Returns an equivalent stream that is unordered.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.stream.LongStream
builder, concat, empty, generate, iterate, of, of, parallel, range, rangeClosed, sequential

Methods inherited from interface java.util.stream.BaseStream
close, isParallel, onClose, unordered

- Method Detail
  - parallelStream
```
public static LongStream parallelStream(long[] array,
                                        ForkJoinPool workerPool)
```
    Creates a parallel long stream from the given Array. This operation is similar to calling Arrays.stream(array).parallel() with the difference that a parallel terminal operation will be executed in the given ForkJoinPool.
    
    Parameters:
    
    array - Array to create the parallel stream from. Must not be null.
    
    workerPool - Thread pool for parallel execution of a terminal operation. Must not be null.
    
    Returns:
    
    A parallel long stream that executes a terminal operation in the given ForkJoinPool.
    
    See Also:
    
    Arrays.stream(long[])
  - parallelStream
```
public static LongStream parallelStream(Spliterator.OfLong spliterator,
                                        ForkJoinPool workerPool)
```
    Creates a parallel long stream from the given Spliterator. This operation is similar to calling StreamSupport.longStream(spliterator, true) with the difference that a parallel terminal operation will be executed in the given ForkJoinPool.
    
    Parameters:
    
    spliterator - A Spliterator.OfLong describing the stream elements. Must not be null.
    
    workerPool - Thread pool for parallel execution of a terminal operation. Must not be null.
    
    Returns:
    
    A parallel long stream that executes a terminal operation in the given ForkJoinPool.
    
    See Also:
    
    StreamSupport.longStream(Spliterator.OfLong, boolean)
  - parallelStream
```
public static LongStream parallelStream(Supplier<? extends Spliterator.OfLong> supplier,
                                        int characteristics,
                                        ForkJoinPool workerPool)
```
    Creates a parallel long stream from the given Spliterator supplier. This operation is similar to calling StreamSupport.longStream(supplier, characteristics, true) with the difference that a parallel terminal operation will be executed in the given ForkJoinPool.
    
    Parameters:
    
    supplier - A Supplier of a Spliterator.OfLong. Must not be null.
    
    characteristics - Spliterator characteristics of the supplied Spliterator. The characteristics must be equal to supplier.get().characteristics(), otherwise undefined behavior may occur when terminal operation commences.
    
    workerPool - Thread pool for parallel execution of a terminal operation. Must not be null.
    
    Returns:
    
    A parallel long stream that executes a terminal operation in the given ForkJoinPool.
    
    See Also:
    
    StreamSupport.longStream(Supplier, int, boolean)
  - parallelStream
```
public static LongStream parallelStream(LongStream.Builder builder,
                                        ForkJoinPool workerPool)
```
    Creates a parallel long stream from the given Builder. This operation is similar to calling builder.build().parallel() with the difference that a parallel terminal operation will be executed in the given ForkJoinPool.
    
    Parameters:
    
    builder - The builder to create the stream from. Must not be null.
    
    workerPool - Thread pool for parallel execution of a terminal operation. Must not be null.
    
    Returns:
    
    A parallel long stream that executes a terminal operation in the given ForkJoinPool. builder()
  - iterate
```
public static LongStream iterate(long seed,
                                 LongUnaryOperator operator,
                                 ForkJoinPool workerPool)
```
    Creates a parallel infinite ordered long stream produced by iterative application of a function f to an initial element seed. This operation is similar to calling LongStream.iterate(seed, operator).parallel() with the difference that a parallel terminal operation will be executed in the given ForkJoinPool.
    
    Parameters:
    
    seed - The initial element.
    
    operator - A function to be applied to to the previous element to produce a new element. Must not be null.
    
    workerPool - Thread pool for parallel execution of a terminal operation. Must not be null.
    
    Returns:
    
    A parallel long stream that executes a terminal operation in the given ForkJoinPool.
    
    See Also:
    
    LongStream.iterate(long, LongUnaryOperator)
  - generate
```
public static LongStream generate(LongSupplier supplier,
                                  ForkJoinPool workerPool)
```
    Creates a parallel infinite sequential unordered long stream where each element is generated by the provided LongSupplier. This operation is similar to calling LongStream.generate(supplier).parallel() with the difference that a parallel terminal operation will be executed in the given ForkJoinPool.
    
    Parameters:
    
    supplier - The LongSupplier of generated elements. Must not be null.
    
    workerPool - Thread pool for parallel execution of a terminal operation. Must not be null.
    
    Returns:
    
    A parallel long stream that executes a terminal operation in the given ForkJoinPool.
    
    See Also:
    
    LongStream.generate(LongSupplier)
  - range
```
public static LongStream range(long startInclusive,
                               long endExclusive,
                               ForkJoinPool workerPool)
```
    Creates a parallel ordered long stream from startInclusive (inclusive) to endExclusive (exclusive) by an incremental step of 1. This operation is similar to calling LongStream.range(startInclusive, endExclusive).parallel() with the difference that a parallel terminal operation will be executed in the given ForkJoinPool.
    
    Parameters:
    
    startInclusive - the (inclusive) initial value
    
    endExclusive - the exclusive upper bound
    
    workerPool - Thread pool for parallel execution of a terminal operation. Must not be null.
    
    Returns:
    
    A parallel long stream that executes a terminal operation in the given ForkJoinPool for the range of long elements.
    
    See Also:
    
    LongStream.range(long, long)
  - rangeClosed
```
public static LongStream rangeClosed(long startInclusive,
                                     long endInclusive,
                                     ForkJoinPool workerPool)
```
    Creates a parallel ordered long stream from startInclusive (inclusive) to endInclusive (inclusive) by an incremental step of 1. This operation is similar to calling LongStream.rangeClosed(startInclusive, endInclusive).parallel() with the difference that a parallel terminal operation will be executed in the given ForkJoinPool.
    
    Parameters:
    
    startInclusive - the (inclusive) initial value
    
    endInclusive - the inclusive upper bound
    
    workerPool - Thread pool for parallel execution of a terminal operation. Must not be null.
    
    Returns:
    
    A parallel long stream that executes a terminal operation in the given ForkJoinPool for the range of long elements.
    
    See Also:
    
    LongStream.rangeClosed(long, long)
  - concat
```
public static LongStream concat(LongStream a,
                                LongStream b,
                                ForkJoinPool workerPool)
```
    Creates a lazily concatenated parallel long stream whose elements are all the elements of the first stream followed by all the elements of the second stream. This operation is similar to calling LongStream.concat(a, b).parallel() with the difference that a parallel terminal operation will be executed in the given ForkJoinPool.
    
    Parameters:
    
    a - The first stream. Must not be null.
    
    b - The second stream. Must not be null.
    
    workerPool - Thread pool for parallel execution of a terminal operation. Must not be null.
    
    Returns:
    
    A parallel stream that executes a terminal operation in the given ForkJoinPool.
    
    See Also:
    
    LongStream.concat(LongStream, LongStream)
  - filter
```
public LongStream filter(LongPredicate predicate)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a stream consisting of the elements of this stream that match the given predicate.
    This is an intermediate operation.
    
    Specified by:
    
    filter in interface LongStream
    
    Parameters:
    
    predicate - a non-interfering, stateless predicate to apply to each element to determine if it should be included
    
    Returns:
    
    the new stream
  - map
```
public LongStream map(LongUnaryOperator mapper)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a stream consisting of the results of applying the given function to the elements of this stream.
    This is an intermediate operation.
    
    Specified by:
    
    map in interface LongStream
    
    Parameters:
    
    mapper - a non-interfering, stateless function to apply to each element
    
    Returns:
    
    the new stream
  - mapToObj
```
public <U> Stream<U> mapToObj(LongFunction<? extends U> mapper)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns an object-valued Stream consisting of the results of applying the given function to the elements of this stream.
    This is an intermediate operation.
    
    Specified by:
    
    mapToObj in interface LongStream
    
    Type Parameters:
    
    U - the element type of the new stream
    
    Parameters:
    
    mapper - a non-interfering, stateless function to apply to each element
    
    Returns:
    
    the new stream
  - mapToInt
```
public IntStream mapToInt(LongToIntFunction mapper)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns an IntStream consisting of the results of applying the given function to the elements of this stream.
    This is an intermediate operation.
    
    Specified by:
    
    mapToInt in interface LongStream
    
    Parameters:
    
    mapper - a non-interfering, stateless function to apply to each element
    
    Returns:
    
    the new stream
  - mapToDouble
```
public DoubleStream mapToDouble(LongToDoubleFunction mapper)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a DoubleStream consisting of the results of applying the given function to the elements of this stream.
    This is an intermediate operation.
    
    Specified by:
    
    mapToDouble in interface LongStream
    
    Parameters:
    
    mapper - a non-interfering, stateless function to apply to each element
    
    Returns:
    
    the new stream
  - flatMap
```
public LongStream flatMap(LongFunction<? extends LongStream> mapper)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a stream consisting of the results of replacing each element of this stream with the contents of a mapped stream produced by applying the provided mapping function to each element. Each mapped stream is closed after its contents have been placed into this stream. (If a mapped stream is null an empty stream is used, instead.)
    This is an intermediate operation.
    
    Specified by:
    
    flatMap in interface LongStream
    
    Parameters:
    
    mapper - a non-interfering, stateless function to apply to each element which produces a LongStream of new values
    
    Returns:
    
    the new stream
    
    See Also:
    
    Stream.flatMap(Function)
  - distinct
```
public LongStream distinct()
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a stream consisting of the distinct elements of this stream.
    This is a stateful intermediate operation.
    
    Specified by:
    
    distinct in interface LongStream
    
    Returns:
    
    the new stream
  - sorted
```
public LongStream sorted()
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a stream consisting of the elements of this stream in sorted order.
    This is a stateful intermediate operation.
    
    Specified by:
    
    sorted in interface LongStream
    
    Returns:
    
    the new stream
  - peek
```
public LongStream peek(LongConsumer action)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a stream consisting of the elements of this stream, additionally performing the provided action on each element as elements are consumed from the resulting stream.
    This is an intermediate operation.
    For parallel stream pipelines, the action may be called at whatever time and in whatever thread the element is made available by the upstream operation. If the action modifies shared state, it is responsible for providing the required synchronization.
    
    Specified by:
    
    peek in interface LongStream
    
    Parameters:
    
    action - a non-interfering action to perform on the elements as they are consumed from the stream
    
    Returns:
    
    the new stream
  - limit
```
public LongStream limit(long maxSize)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a stream consisting of the elements of this stream, truncated to be no longer than maxSize in length.
    This is a short-circuiting stateful intermediate operation.
    
    Specified by:
    
    limit in interface LongStream
    
    Parameters:
    
    maxSize - the number of elements the stream should be limited to
    
    Returns:
    
    the new stream
  - skip
```
public LongStream skip(long n)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a stream consisting of the remaining elements of this stream after discarding the first n elements of the stream. If this stream contains fewer than n elements then an empty stream will be returned.
    This is a stateful intermediate operation.
    
    Specified by:
    
    skip in interface LongStream
    
    Parameters:
    
    n - the number of leading elements to skip
    
    Returns:
    
    the new stream
  - forEach
```
public void forEach(LongConsumer action)
```
    Description copied from interface: java.util.stream.LongStream
    
    Performs an action for each element of this stream.
    This is a terminal operation.
    For parallel stream pipelines, this operation does not guarantee to respect the encounter order of the stream, as doing so would sacrifice the benefit of parallelism. For any given element, the action may be performed at whatever time and in whatever thread the library chooses. If the action accesses shared state, it is responsible for providing the required synchronization.
    
    Specified by:
    
    forEach in interface LongStream
    
    Parameters:
    
    action - a non-interfering action to perform on the elements
  - forEachOrdered
```
public void forEachOrdered(LongConsumer action)
```
    Description copied from interface: java.util.stream.LongStream
    
    Performs an action for each element of this stream, guaranteeing that each element is processed in encounter order for streams that have a defined encounter order.
    This is a terminal operation.
    
    Specified by:
    
    forEachOrdered in interface LongStream
    
    Parameters:
    
    action - a non-interfering action to perform on the elements
    
    See Also:
    
    LongStream.forEach(LongConsumer)
  - toArray
```
public long[] toArray()
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns an array containing the elements of this stream.
    This is a terminal operation.
    
    Specified by:
    
    toArray in interface LongStream
    
    Returns:
    
    an array containing the elements of this stream
  - reduce
```
public long reduce(long identity,
                   LongBinaryOperator op)
```
    Description copied from interface: java.util.stream.LongStream
    Performs a reduction on the elements of this stream, using the provided identity value and an associative accumulation function, and returns the reduced value. This is equivalent to:
```
     long result = identity;
     for (long element : this stream)
         result = accumulator.applyAsLong(result, element)
     return result;
 
```
    but is not constrained to execute sequentially.
    The identity value must be an identity for the accumulator function. This means that for all x, accumulator.apply(identity, x) is equal to x. The accumulator function must be an associative function.
    This is a terminal operation.
    Specified by:
    
    reduce in interface LongStream
    
    Parameters:
    
    identity - the identity value for the accumulating function
    
    op - an associative, non-interfering, stateless function for combining two values
    
    Returns:
    
    the result of the reduction
    
    See Also:
    
    LongStream.sum(), LongStream.min(), LongStream.max(), LongStream.average()
  - reduce
```
public OptionalLong reduce(LongBinaryOperator op)
```
    Description copied from interface: java.util.stream.LongStream
    Performs a reduction on the elements of this stream, using an associative accumulation function, and returns an OptionalLong describing the reduced value, if any. This is equivalent to:
```
     boolean foundAny = false;
     long result = null;
     for (long element : this stream) {
         if (!foundAny) {
             foundAny = true;
             result = element;
         }
         else
             result = accumulator.applyAsLong(result, element);
     }
     return foundAny ? OptionalLong.of(result) : OptionalLong.empty();
 
```
    but is not constrained to execute sequentially.
    The accumulator function must be an associative function.
    This is a terminal operation.
    Specified by:
    
    reduce in interface LongStream
    
    Parameters:
    
    op - an associative, non-interfering, stateless function for combining two values
    
    Returns:
    
    the result of the reduction
    
    See Also:
    
    LongStream.reduce(long, LongBinaryOperator)
  - collect
```
public <R> R collect(Supplier<R> supplier,
                     ObjLongConsumer<R> accumulator,
                     BiConsumer<R,R> combiner)
```
    Description copied from interface: java.util.stream.LongStream
    Performs a mutable reduction operation on the elements of this stream. A mutable reduction is one in which the reduced value is a mutable result container, such as an ArrayList, and elements are incorporated by updating the state of the result rather than by replacing the result. This produces a result equivalent to:
```
     R result = supplier.get();
     for (long element : this stream)
         accumulator.accept(result, element);
     return result;
 
```
    Like LongStream.reduce(long, LongBinaryOperator), collect operations can be parallelized without requiring additional synchronization.
    This is a terminal operation.
    Specified by:
    
    collect in interface LongStream
    
    Type Parameters:
    
    R - type of the result
    
    Parameters:
    
    supplier - a function that creates a new result container. For a parallel execution, this function may be called multiple times and must return a fresh value each time.
    
    accumulator - an associative, non-interfering, stateless function for incorporating an additional element into a result
    
    combiner - an associative, non-interfering, stateless function for combining two values, which must be compatible with the accumulator function
    
    Returns:
    
    the result of the reduction
    
    See Also:
    
    Stream.collect(Supplier, BiConsumer, BiConsumer)
  - sum
```
public long sum()
```
    Description copied from interface: java.util.stream.LongStream
    Returns the sum of elements in this stream. This is a special case of a reduction and is equivalent to:
```
     return reduce(0, Long::sum);
 
```
    This is a terminal operation.
    Specified by:
    
    sum in interface LongStream
    
    Returns:
    
    the sum of elements in this stream
  - min
```
public OptionalLong min()
```
    Description copied from interface: java.util.stream.LongStream
    Returns an OptionalLong describing the minimum element of this stream, or an empty optional if this stream is empty. This is a special case of a reduction and is equivalent to:
```
     return reduce(Long::min);
 
```
    This is a terminal operation.
    Specified by:
    
    min in interface LongStream
    
    Returns:
    
    an OptionalLong containing the minimum element of this stream, or an empty OptionalLong if the stream is empty
  - max
```
public OptionalLong max()
```
    Description copied from interface: java.util.stream.LongStream
    Returns an OptionalLong describing the maximum element of this stream, or an empty optional if this stream is empty. This is a special case of a reduction and is equivalent to:
```
     return reduce(Long::max);
 
```
    This is a terminal operation.
    Specified by:
    
    max in interface LongStream
    
    Returns:
    
    an OptionalLong containing the maximum element of this stream, or an empty OptionalLong if the stream is empty
  - count
```
public long count()
```
    Description copied from interface: java.util.stream.LongStream
    Returns the count of elements in this stream. This is a special case of a reduction and is equivalent to:
```
     return map(e -> 1L).sum();
 
```
    This is a terminal operation.
    Specified by:
    
    count in interface LongStream
    
    Returns:
    
    the count of elements in this stream
  - average
```
public OptionalDouble average()
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns an OptionalDouble describing the arithmetic mean of elements of this stream, or an empty optional if this stream is empty. This is a special case of a reduction.
    This is a terminal operation.
    
    Specified by:
    
    average in interface LongStream
    
    Returns:
    
    an OptionalDouble containing the average element of this stream, or an empty optional if the stream is empty
  - summaryStatistics
```
public LongSummaryStatistics summaryStatistics()
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a LongSummaryStatistics describing various summary data about the elements of this stream. This is a special case of a reduction.
    This is a terminal operation.
    
    Specified by:
    
    summaryStatistics in interface LongStream
    
    Returns:
    
    a LongSummaryStatistics describing various summary data about the elements of this stream
  - anyMatch
```
public boolean anyMatch(LongPredicate predicate)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns whether any elements of this stream match the provided predicate. May not evaluate the predicate on all elements if not necessary for determining the result. If the stream is empty then false is returned and the predicate is not evaluated.
    This is a short-circuiting terminal operation.
    
    Specified by:
    
    anyMatch in interface LongStream
    
    Parameters:
    
    predicate - a non-interfering, stateless predicate to apply to elements of this stream
    
    Returns:
    
    true if any elements of the stream match the provided predicate, otherwise false
  - allMatch
```
public boolean allMatch(LongPredicate predicate)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns whether all elements of this stream match the provided predicate. May not evaluate the predicate on all elements if not necessary for determining the result. If the stream is empty then true is returned and the predicate is not evaluated.
    This is a short-circuiting terminal operation.
    
    Specified by:
    
    allMatch in interface LongStream
    
    Parameters:
    
    predicate - a non-interfering, stateless predicate to apply to elements of this stream
    
    Returns:
    
    true if either all elements of the stream match the provided predicate or the stream is empty, otherwise false
  - noneMatch
```
public boolean noneMatch(LongPredicate predicate)
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns whether no elements of this stream match the provided predicate. May not evaluate the predicate on all elements if not necessary for determining the result. If the stream is empty then true is returned and the predicate is not evaluated.
    This is a short-circuiting terminal operation.
    
    Specified by:
    
    noneMatch in interface LongStream
    
    Parameters:
    
    predicate - a non-interfering, stateless predicate to apply to elements of this stream
    
    Returns:
    
    true if either no elements of the stream match the provided predicate or the stream is empty, otherwise false
  - findFirst
```
public OptionalLong findFirst()
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns an OptionalLong describing the first element of this stream, or an empty OptionalLong if the stream is empty. If the stream has no encounter order, then any element may be returned.
    This is a short-circuiting terminal operation.
    
    Specified by:
    
    findFirst in interface LongStream
    
    Returns:
    
    an OptionalLong describing the first element of this stream, or an empty OptionalLong if the stream is empty
  - findAny
```
public OptionalLong findAny()
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns an OptionalLong describing some element of the stream, or an empty OptionalLong if the stream is empty.
    This is a short-circuiting terminal operation.
    The behavior of this operation is explicitly nondeterministic; it is free to select any element in the stream. This is to allow for maximal performance in parallel operations; the cost is that multiple invocations on the same source may not return the same result. (If a stable result is desired, use LongStream.findFirst() instead.)
    
    Specified by:
    
    findAny in interface LongStream
    
    Returns:
    
    an OptionalLong describing some element of this stream, or an empty OptionalLong if the stream is empty
    
    See Also:
    
    LongStream.findFirst()
  - asDoubleStream
```
public DoubleStream asDoubleStream()
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a DoubleStream consisting of the elements of this stream, converted to double.
    This is an intermediate operation.
    
    Specified by:
    
    asDoubleStream in interface LongStream
    
    Returns:
    
    a DoubleStream consisting of the elements of this stream, converted to double
  - boxed
```
public Stream<Long> boxed()
```
    Description copied from interface: java.util.stream.LongStream
    
    Returns a Stream consisting of the elements of this stream, each boxed to a Long.
    This is an intermediate operation.
    
    Specified by:
    
    boxed in interface LongStream
    
    Returns:
    
    a Stream consistent of the elements of this stream, each boxed to Long
  - iterator
```
public PrimitiveIterator.OfLong iterator()
```
    Description copied from interface: java.util.stream.BaseStream
    
    Returns an iterator for the elements of this stream.
    This is a terminal operation.
    
    Specified by:
    
    iterator in interface BaseStream<Long,LongStream>
    
    Specified by:
    
    iterator in interface LongStream
    
    Returns:
    
    the element iterator for this stream
  - spliterator
```
public Spliterator.OfLong spliterator()
```
    Description copied from interface: java.util.stream.BaseStream
    
    Returns a spliterator for the elements of this stream.
    This is a terminal operation.
    
    Specified by:
    
    spliterator in interface BaseStream<Long,LongStream>
    
    Specified by:
    
    spliterator in interface LongStream
    
    Returns:
    
    the element spliterator for this stream
  - isParallel
```
public boolean isParallel()
```
    Description copied from interface: java.util.stream.BaseStream
    
    Returns whether this stream, if a terminal operation were to be executed, would execute in parallel. Calling this method after invoking an terminal stream operation method may yield unpredictable results.
    
    Specified by:
    
    isParallel in interface BaseStream<T,S extends BaseStream<T,S>>
    
    Returns:
    
    true if this stream would execute in parallel if executed
  - sequential
```
public S sequential()
```
    Description copied from interface: java.util.stream.BaseStream
    
    Returns an equivalent stream that is sequential. May return itself, either because the stream was already sequential, or because the underlying stream state was modified to be sequential.
    This is an intermediate operation.
    
    Specified by:
    
    sequential in interface BaseStream<T,S extends BaseStream<T,S>>
    
    Returns:
    
    a sequential stream
  - parallel
```
public S parallel()
```
    Description copied from interface: java.util.stream.BaseStream
    
    Returns an equivalent stream that is parallel. May return itself, either because the stream was already parallel, or because the underlying stream state was modified to be parallel.
    This is an intermediate operation.
    
    Specified by:
    
    parallel in interface BaseStream<T,S extends BaseStream<T,S>>
    
    Returns:
    
    a parallel stream
  - unordered
```
public S unordered()
```
    Description copied from interface: java.util.stream.BaseStream
    
    Returns an equivalent stream that is unordered. May return itself, either because the stream was already unordered, or because the underlying stream state was modified to be unordered.
    This is an intermediate operation.
    
    Specified by:
    
    unordered in interface BaseStream<T,S extends BaseStream<T,S>>
    
    Returns:
    
    an unordered stream
  - onClose
```
public S onClose(Runnable closeHandler)
```
    Description copied from interface: java.util.stream.BaseStream
    
    Returns an equivalent stream with an additional close handler. Close handlers are run when the BaseStream.close() method is called on the stream, and are executed in the order they were added. All close handlers are run, even if earlier close handlers throw exceptions. If any close handler throws an exception, the first exception thrown will be relayed to the caller of close(), with any remaining exceptions added to that exception as suppressed exceptions (unless one of the remaining exceptions is the same exception as the first exception, since an exception cannot suppress itself.) May return itself.
    This is an intermediate operation.
    
    Specified by:
    
    onClose in interface BaseStream<T,S extends BaseStream<T,S>>
    
    Parameters:
    
    closeHandler - A task to execute when the stream is closed
    
    Returns:
    
    a stream with a handler that is run if the stream is closed
  - close
```
public void close()
```
    Description copied from interface: java.util.stream.BaseStream
    
    Closes this stream, causing all close handlers for this stream pipeline to be called.
    
    Specified by:
    
    close in interface AutoCloseable
    
    Specified by:
    
    close in interface BaseStream<T,S extends BaseStream<T,S>>
    
    See Also:
    
    AutoCloseable.close()
  - execute
```
protected void execute(Runnable terminalOperation)
```
  - execute
```
protected <R> R execute(Callable<R> terminalOperation)
```

Class ParallelLongStreamSupport

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.stream.LongStream

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.stream.LongStream

Methods inherited from interface java.util.stream.BaseStream

Method Detail

parallelStream

parallelStream

parallelStream

parallelStream

iterate

generate

range

rangeClosed

concat

filter

map

mapToObj

mapToInt

mapToDouble

flatMap

distinct

sorted

peek

limit

skip

forEach

forEachOrdered

toArray

reduce

reduce

collect

sum

min

max

count

average

summaryStatistics

anyMatch

allMatch

noneMatch

findFirst

findAny

asDoubleStream

boxed

iterator

spliterator

isParallel

sequential

parallel

unordered

onClose

close

execute

execute