Home » Java programming language

Java ArrayDeque getFirst() Method with Example

ArrayDeque Class getFirst() method: Here, we are going to learn about the getFirst() method of ArrayDeque Class with its syntax and example.
Submitted by Preeti Jain, on January 09, 2020

ArrayDeque Class getFirst() method

• getFirst() Method is available in java.lang package.
• getFirst() Method is used to retrieve the first element of the deque but without removing the element from this deque.
• getFirst() Method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• getFirst() Method may throw an exception at the time of retrieving the deque element.
  NoSuchElementException: This exception may throw when the deque is “blank” (i.e. Deque contains no elements).

Syntax:

    public T getFirst();

Parameter(s):

• It does not accept any parameter.

Return value:

The return type of the method is T, it returns first element of this deque.

Example:

// Java program to demonstrate the example 
// of T getFirst() method of ArrayDeque 

import java.util.*;

public class GetFirstOfArrayDeque {
    public static void main(String[] args) {
        // Creating an ArrayDeque with initial capacity of
        // storing elements
        Deque < String > d_queue = new ArrayDeque < String > (10);

        // By using add() method to add elements
        // in ArrayDeque
        d_queue.add("C");
        d_queue.add("C++");
        d_queue.add("Java");
        d_queue.add("Php");
        d_queue.add("DotNet");

        // Display Deque Elements
        System.out.println("d_queue : ");
        System.out.println("ArrayDeque Elements = " + d_queue);

        System.out.println();

        // By using getFirst() method is to return the
        // first element of ArrayDeque
        String ele = d_queue.getFirst();
        System.out.println("d_queue.getFirst() : " + ele);
    }
}

Output

d_queue : 
ArrayDeque Elements = [C, C++, Java, Php, DotNet]

d_queue.getFirst() : C