Collections Framework – The Deque Interface

In this guide, we will learn about the Deque interface of the Java Collections framework.

A deque is a double-ended-queue. A double-ended-queue is a linear collection of elements that supports the insertion and removal of elements at both end points

The Deque interface is a richer abstract data type than both Stack and Queue because it implements both stacks and queues at the same time.

The Deque interface defines methods to access the elements at both ends of the Deque instance. Methods are provided to insert, remove, and examine the elements.
Predefined classes like ArrayDeque and LinkedList implement the Deque interface.

Deque interface Methods

Note that the Deque interface can be used both as last-in-first-out stacks and first-in-first-out queues. 
The methods given in the Deque interface are divided into three parts:

Insert

The addfirst and offerFirst methods insert elements at the beginning of the Deque instance. The methods addLast and offerLast insert elements at the end of the Deque instance. 
When the capacity of the Deque instance is restricted, the preferred methods are offerFirst and offerLast because addFirst might fail to throw an exception if it is full.

Remove

The removeFirst and pollFirst methods remove elements from the beginning of the Deque instance. The removeLast and pollLast methods remove elements from the end. The methods pollFirst and pollLast return null if the Deque is empty whereas the methods removeFirst and removeLast throw an exception if the Deque instance is empty.

Retrieve

The methods getFirst and peekFirst retrieve the first element of the Deque instance. These methods don't remove the value from the Deque instance. Similarly, the methods getLast and peekLast retrieve the last element. 
The methods getFirst and getLast throw an exception if the deque instance is empty whereas the methods peekFirst and peekLast return NULL.

Deque interface Class Diagram

Below diagram shows a list of APIs/Methods that deque interface provides.

Deque Interface Hierarchy Diagram

ArrayDeque implementation of Deque Interface Examples

Java ArrayDeque Example

import java.util.ArrayDeque;
import java.util.Deque;

public class ArrayDequeExample {
    public static void main(String[] args) {
     // Creating Deque and adding elements
     Deque<String> deque = new ArrayDeque<String>();
     deque.add("element1");
     deque.add("element2");
     deque.add("element3");
     // Traversing elements
     for (String str : deque) {
        System.out.println(str);
     }
   }
}
Output:
element1
element2
element3

Java ArrayDeque Example: offerFirst() and pollLast()

package com.javaguides.collections.queueexamples;

import java.util.ArrayDeque;
import java.util.Deque;

public class DequeExample {
    public static void main(String[] args) {
        Deque < String > deque = new ArrayDeque < String > ();
        deque.offer("element1");
        deque.offer("element2");
        deque.add("element3");
        deque.offerFirst("element4");
        System.out.println("After offerFirst Traversal...");
        for (String s: deque) {
            System.out.println(s);
        }
        // deque.poll();
        // deque.pollFirst();//it is same as poll()
        deque.pollLast();
        System.out.println("After pollLast() Traversal...");
        for (String s: deque) {
            System.out.println(s);
        }
    }
}

Output:
After offerFirst Traversal...
element4
element1
element2
element3
After pollLast() Traversal...
element4
element1
element2

Reference

https://docs.oracle.com/en/java/javase/18/docs/api/java.base/java/util/Deque.html

Free Spring Boot Tutorial | Full In-depth Course | Learn Spring Boot in 10 Hours


Watch this course on YouTube at Spring Boot Tutorial | Fee 10 Hours Full Course

Comments