Open In App

LongStream.Builder add(long t) in Java

Improve
Improve
Like Article
Like
Save
Share
Report

LongStream.Builder add(long t) is used to insert an element into the element in the building phase of stream. It adds an element to the stream being built.

Syntax:

default LongStream.Builder add(long t)

Parameters: This method accepts a mandatory parameter t which is the element to input into the stream.

Exceptions: This method throws IllegalStateException when the builder has already transitioned to the built state. It means that the stream has entered the built phase and now no it can’t be changed. Hence no more elements can be added into the stream.

Below are the examples to illustrate add() method:

Example 1:




// Java code to show the implementation
// of LongStream.Builder add(long t)
  
import java.util.stream.LongStream;
  
class GFG {
  
    // Driver code
    public static void main(String[] args)
    {
  
        // Declaring an empty Stream
        LongStream.Builder b = LongStream.builder();
  
        // Inserting elements into the stream
        // using LongStream.Builder add(long t)
        b.add(4L);
        b.add(5L);
        b.add(6L);
        b.add(7L);
  
        // Creating the Stream
        // The stream has now entered the built phase
        // printing the elements
        System.out.println("Stream successfully built");
        b.build().forEach(System.out::println);
    }
}


Output:

Stream successfully built
4
5
6
7

Example 2: To illustrate IllegalStateException




// Java code to show the implementation
// of LongStream.Builder add(T t)
  
import java.util.stream.LongStream;
  
class GFG {
  
    // Driver code
    public static void main(String[] args)
    {
  
        // Declaring an empty Stream
        LongStream.Builder b = LongStream.builder();
  
        // using LongStream.Builder add(T t)
        b.add(4L);
        b.add(5L);
        b.add(6L);
        b.add(7L);
  
        // Creating the Stream
        // The stream has now entered the built phase
        // printing the elements
        System.out.println("Stream successfully built");
        b.build().forEach(System.out::println);
  
        // Trying to add another element into the stream
        // Since the Stream is in built phase
        // This operation is not possible now
        // Hence add() will throw exception now
  
        try {
            b.add(50L);
        }
        catch (Exception e) {
            System.out.println("Exception thrown "
                               + "when now adding element into the stream: "
                               + e);
        }
    }
}


Output:

Stream successfully built
4
5
6
7
Exception thrown when now adding element into the stream: java.lang.IllegalStateException


Last Updated : 06 Dec, 2018
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads