ArrayDeque peekFirst() Method in Java

The java.util.ArrayDeque.peekFirst() method in Java is used to retrieve or fetch the first element of the deque. The element retrieved does not get deleted or removed from the Queue instead the method just returns it. If no element is present in the deque or it is empty, then Null is returned.

Syntax:

Array_Deque.peekFirst()

Parameters: The method does not take any parameter.

Return Value: The method returns the first element of the Deque.

Below programs illustrate the Java.util.ArrayDeque.peekFirst() method:
Program 1:

// Java code to illustrate peekFirst()
import java.util.*;

public class ArrayDequeDemo {
    public static void main(String args[])
    {
        // Creating an empty ArrayDeque
        Deque<String> de_que = new ArrayDeque<String>();

        // Use add() method to add elements into the Deque
        de_que.add("Welcome");
        de_que.add("To");
        de_que.add("Geeks");
        de_que.add("4");
        de_que.add("Geeks");

        // Displaying the ArrayDeque
        System.out.println("Initial ArrayDeque: " + de_que);

        // Displaying the first element
        System.out.println("The first element is: " +
                                           de_que.peekFirst());

        // Displaying the ArrayDeque after operation
        System.out.println("Final ArrayDeque: " + de_que);
    }
}

Output:

Initial ArrayDeque: [Welcome, To, Geeks, 4, Geeks]
The first element is: Welcome
Final ArrayDeque: [Welcome, To, Geeks, 4, Geeks]

Program 2:

// Java code to illustrate peekFirst()
import java.util.*;

public class ArrayDequeDemo {
    public static void main(String args[])
    {
        // Creating an empty ArrayDeque
        Deque<Integer> de_que = new ArrayDeque<Integer>();

        // Use add() method to add elements into the Deque
        de_que.add(10);
        de_que.add(15);
        de_que.add(30);
        de_que.add(20);
        de_que.add(5);

        // Displaying the ArrayDeque
        System.out.println("Initial ArrayDeque: " + de_que);

        // Displaying the first element
        System.out.println("The first element is: " +
                                           de_que.peekFirst());

        // Displaying the ArrayDeque after operation
        System.out.println("Final ArrayDeque: " + de_que);
    }
}

Output:

Initial ArrayDeque: [10, 15, 30, 20, 5]
The first element is: 10
Final ArrayDeque: [10, 15, 30, 20, 5]

Program 3: For an empty deque:

// Java code to illustrate peekFirst()
import java.util.*;

public class ArrayDequeDemo {
    public static void main(String args[])
    {
        // Creating an empty ArrayDeque
        ArrayDeque<Integer> de_que = new ArrayDeque<Integer>();

        // Displaying the ArrayDeque
        System.out.println("ArrayDeque: " + de_que);

        // Displaying the first element
        System.out.println("The first element is: " +
                                     de_que.peekFirst());
    }
}

Output:

ArrayDeque: []
The first element is: null