Java ArrayDeque pollFirst() Method

📘 Premium Read: Access my best content on Medium member-only articles — deep dives into Java, Spring Boot, Microservices, backend architecture, interview preparation, career advice, and industry-standard best practices.

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (176K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

The ArrayDeque class in Java provides the pollFirst() method to retrieve and remove the first element of the deque.

Table of Contents

1. Introduction
2. pollFirst Method Syntax
3. Examples
   • Retrieving and Removing the First Element of the ArrayDeque Using pollFirst
   • Handling an Empty ArrayDeque
4. Real-World Use Case
   • Use Case: Task Management System
5. Conclusion

Introduction

The ArrayDeque.pollFirst() method is used to retrieve and remove the first element of the ArrayDeque. If the deque is empty, the method returns null instead of throwing an exception, making it a safe way to remove the first element.

pollFirst Method Syntax

The syntax for the pollFirst method is as follows:

public E pollFirst() 

• The method does not take any parameters.
• The method returns the first element of the deque, or null if the deque is empty.

Examples

Retrieving and Removing the First Element of the ArrayDeque Using pollFirst

The pollFirst method can be used to retrieve and remove the first element of an ArrayDeque.

Example

import java.util.ArrayDeque; public class ArrayDequePollFirstExample { public static void main(String[] args) { // Creating an ArrayDeque of Strings ArrayDeque<String> tasks = new ArrayDeque<>(); // Adding elements to the ArrayDeque tasks.add("Complete project report"); tasks.add("Email client updates"); tasks.add("Prepare presentation"); // Retrieving and removing the first element of the ArrayDeque using pollFirst String firstTask = tasks.pollFirst(); // Printing the first element of the ArrayDeque System.out.println("First element removed from the ArrayDeque: " + firstTask); // Printing the ArrayDeque after removal System.out.println("ArrayDeque after pollFirst: " + tasks); } } 

Output:

First element removed from the ArrayDeque: Complete project report ArrayDeque after pollFirst: [Email client updates, Prepare presentation] 

Handling an Empty ArrayDeque

When the ArrayDeque is empty, the pollFirst method returns null.

Example

import java.util.ArrayDeque; public class EmptyArrayDequePollFirstExample { public static void main(String[] args) { // Creating an empty ArrayDeque of Strings ArrayDeque<String> tasks = new ArrayDeque<>(); // Attempting to retrieve and remove the first element of the empty ArrayDeque using pollFirst String firstTask = tasks.pollFirst(); // Printing the result if (firstTask == null) { System.out.println("ArrayDeque is empty."); } else { System.out.println("First element removed from the ArrayDeque: " + firstTask); } } } 

Output:

ArrayDeque is empty. 

Real-World Use Case

Use Case: Task Management System

In a task management system, you might need to process and remove the highest-priority task from the front of the deque. The pollFirst method can be used to retrieve and remove this task.

Example

import java.util.ArrayDeque; public class TaskManagementSystem { public static void main(String[] args) { // Creating an ArrayDeque to store tasks ArrayDeque<Task> tasks = new ArrayDeque<>(); // Adding initial tasks to the ArrayDeque tasks.add(new Task("Complete project report", 2)); tasks.add(new Task("Email client updates", 1)); tasks.add(new Task("Prepare presentation", 3)); // Retrieving and removing the next task using pollFirst Task nextTask = tasks.pollFirst(); // Printing the next task to be processed if (nextTask == null) { System.out.println("No tasks to process."); } else { System.out.println("Processing next task: " + nextTask); } // Printing the ArrayDeque after removal System.out.println("Remaining tasks in ArrayDeque: " + tasks); } } class Task { private String description; private int priority; public Task(String description, int priority) { this.description = description; this.priority = priority; } @Override public String toString() { return description + " (Priority: " + priority + ")"; } } 

Output:

Processing next task: Complete project report (Priority: 2) Remaining tasks in ArrayDeque: [Email client updates (Priority: 1), Prepare presentation (Priority: 3)] 

Conclusion

The ArrayDeque.pollFirst() method in Java is used for retrieving and removing the first element of a deque. Understanding how to use this method allows you to safely and efficiently manage elements in the deque, making it particularly useful in applications like task management systems where you need to process tasks and remove them from the deque as they are completed.