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
