DoubleStream findFirst() with examples

0 0 1 minute read

DoubleStream findFirst() returns an OptionalDouble (a container object which may or may not contain a non-null value) describing the first element of this stream, or an empty OptionalDouble if the stream is empty.

Syntax :

OptionalDouble findFirst()

Parameters :

OptionalDouble : A container object which may or may not contain a non-null value.

Return Value : The function returns an OptionalDouble describing the first element of this stream, or an empty OptionalDouble if the stream is empty.

Note : findFirst() is a terminal-short-circuiting operation of Stream interface. This method returns any first element satisfying the intermediate operations.

Example 1 : findFirst() method on Double Stream.

// Java code for DoubleStream findFirst()
// which returns an OptionalDouble describing
// first element of the stream, or an
// empty OptionalDouble if the stream is empty.
import java.util.*;
import java.util.stream.DoubleStream;
  
class GFG {
  
    // Driver code
    public static void main(String[] args)
    {
        // Creating an DoubleStream
        DoubleStream stream = DoubleStream.of(6.2, 7.3, 8.4, 9.5);
  
        // Using DoubleStream findFirst() to return
        // an OptionalDouble describing first element
        // of the stream
        OptionalDouble answer = stream.findFirst();
  
        // if the stream is empty, an empty
        // OptionalDouble is returned.
        if (answer.isPresent())
            System.out.println(answer.getAsDouble());
        else
            System.out.println("no value");
    }
}

Output :

6.2

Note : If the stream has no encounter order, then any element may be returned.

Example 2 : findFirst() method to return the first element which is divisible by 4.

// Java code for DoubleStream findFirst()
// which returns an OptionalDouble describing
// first element of the stream, or an
// empty OptionalDouble if the stream is empty.
import java.util.OptionalDouble;
import java.util.stream.DoubleStream;
  
class GFG {
  
    // Driver code
    public static void main(String[] args)
    {
        // Creating an DoubleStream
        DoubleStream stream = DoubleStream.of(4.7, 4.5, 
                    8.0, 10.2, 12.0, 16.0).parallel();
  
        // Using DoubleStream findFirst().
        // Executing the source code multiple times
        // must return the same result.
        // Every time you will get the same
        // Double value which is divisible by 4.
        stream = stream.filter(num -> num % 4.0 == 0);
  
        OptionalDouble answer = stream.findFirst();
        if (answer.isPresent())
            System.out.println(answer.getAsDouble());
    }
}