Close

Java Collections - ArrayDeque.removeFirst() Examples

[Last Updated: Dec 10, 2025]

Java Collections Java Java API 

PreviousNext

Class:

java.util.ArrayDeque

java.lang.Objectjava.lang.Objectjava.util.AbstractCollectionjava.util.AbstractCollectionjava.util.CollectionCollectionjava.util.ArrayDequejava.util.ArrayDequejava.util.DequeDequejava.lang.CloneableCloneablejava.io.SerializableSerializableLogicBig

Method:

public E removeFirst()

Retrieves and removes the first element of this deque. This method differs from pollFirst() only in that it throws an exception if this deque is empty.


Examples


package com.logicbig.example.arraydeque;

import java.util.ArrayDeque;
import java.util.List;

public class RemoveFirstExample {

    public static void main(String... args) {
        ArrayDeque<Integer> ad = new ArrayDeque<>(List.of(3, 8, 1));
        System.out.println(ad);
        Integer b = ad.removeFirst();
        System.out.println(b);
        System.out.println(ad);
        b = ad.removeFirst();
        System.out.println(b);
        System.out.println(ad);
    }
}

Output

[3, 8, 1]
3
[8, 1]
8
[1]
JDK 25




package com.logicbig.example.arraydeque;

import java.util.ArrayDeque;

public class RemoveFirstExample2 {

    public static void main(String... args) {
        ArrayDeque<Integer> ad = new ArrayDeque<>();
        System.out.println(ad);
        Integer integer = ad.removeFirst();
        System.out.println(integer);
        System.out.println(ad);
    }
}

Output

[]
java.util.NoSuchElementException
    at java.util.ArrayDeque.removeFirst (ArrayDeque.java:360)
    at com.logicbig.example.arraydeque.RemoveFirstExample2.main (RemoveFirstExample2.java:15)
    at jdk.internal.reflect.DirectMethodHandleAccessor.invoke (DirectMethodHandleAccessor.java:104)
    at java.lang.reflect.Method.invoke (Method.java:565)
    at org.codehaus.mojo.exec.AbstractExecJavaBase.executeMainMethod (AbstractExecJavaBase.java:402)
    at org.codehaus.mojo.exec.ExecJavaMojo.executeMainMethod (ExecJavaMojo.java:142)
    at org.codehaus.mojo.exec.AbstractExecJavaBase.doExecClassLoader (AbstractExecJavaBase.java:377)
    at org.codehaus.mojo.exec.AbstractExecJavaBase.lambda$execute$0 (AbstractExecJavaBase.java:287)
    at java.lang.Thread.run (Thread.java:1474)
JDK 25

See Also