DoubleStream reduce(DoubleBinaryOperator op) performs a reduction on the elements of this stream, using an associative accumulation function, and returns an OptionalDouble describing the reduced value, if any.
A reduction operation or fold takes a sequence of input elements and combines them into a single summary result, such as finding the sum or maximum of a set of numbers. An operator or function op is associative if the following holds :
(a op b) op c == a op (b op c)
This is a terminal operation i.e, it may traverse the stream to produce a result or a side-effect. After the terminal operation is performed, the stream pipeline is considered consumed, and can no longer be used.
Syntax :
OptionalDouble reduce(DoubleBinaryOperator op)
Parameters :
- OptionalDouble : A container object which may or may not contain a long value. If a value is present, isPresent() will return true and getAsDouble() will return the value.
- DoubleBinaryOperator : An operation upon two double-valued operands and producing a double-valued result.
- op : An associative, stateless function for combining two values.
Return Value : An OptionalDouble describing the reduced value, if any.
Example 1 :
// Java code for DoubleStream reduce // (DoubleBinaryOperator op) import java.util.OptionalDouble; import java.util.stream.DoubleStream;   class GFG {       // Driver code     public static void main(String[] args)     {         // Creating a DoubleStream         DoubleStream stream = DoubleStream.of( 1.2 , 2.3 , 3.4 , 4.5 );           // Using OptionalDouble (a container object which         // may or may not contain a non-null value)         // Using DoubleStream reduce(DoubleBinaryOperator op)         OptionalDouble answer = stream.reduce(Double::sum);           // if the stream is empty, an empty         // OptionalDouble is returned.         if (answer.isPresent()) {             System.out.println(answer.getAsDouble());         }         else {             System.out.println( "Stream is empty" );         }     } } |
Output :
11.4
Example 2 :
// Java code for DoubleStream reduce // (DoubleBinaryOperator op) import java.util.OptionalDouble; import java.util.stream.DoubleStream;   class GFG {       // Driver code     public static void main(String[] args)     {         // Creating a DoubleStream         DoubleStream stream = DoubleStream.of( 1.2 , 2.3 , 3.4 , 4.5 );           // Using OptionalDouble (a container object which         // may or may not contain a non-null value)         // Using DoubleStream reduce(DoubleBinaryOperator op)         OptionalDouble answer = stream.reduce((a, b)                                   -> (a * b) * (a * b));           // if the stream is empty, an empty         // OptionalDouble is returned.         if (answer.isPresent()) {             System.out.println(answer.getAsDouble());         }         else {             System.out.println( "Stream is empty" );         }     } } |
Output :
9111992.471343633