ArrayList remove() method example

ArrayList remove() removes the first occurrence of the specified element from this list, if it is present. If the list does not contain the element, list remain unchanged.

1. ArrayList remove() method

The remove() method is overloaded and comes in two variants:

• remove(Object o) – removes the first occurance of the specified element from the list.
• remove(int index) – removes the element at the specified position in this list. Shifts any subsequent elements to the left.

Method parameter – Object to be removed or index of the object.
Method returns – true if object was found and removed. Else false.
Method throws – IndexOutOfBoundsException – if the index is out of range (less than 0 or greater than list size).

2. ArrayList remove(Object o) example

2.1. Remove only first occurrence

Java program to remove an object from an arraylist using remove() method.

import java.util.ArrayList;
import java.util.Arrays;

public class ArrayListExample 
{
    public static void main(String[] args) throws CloneNotSupportedException 
    {
        ArrayList<String> alphabets = new ArrayList<>(Arrays.asList("A", "B", "C", "D"));
        
        System.out.println(alphabets);
        
        alphabets.remove("C");          //Element is present
        
        System.out.println(alphabets);
        
        alphabets.remove("Z");          //Element is NOT present
        
        System.out.println(alphabets);
    }
}

Program output.

[A, B, C, D]
[A, B, D]
[A, B, D]

2.2. Remove all occurrences of element

We cannot directly remove all occurrences of any element from list using remove() method. We can use removeAll() method for this purpose.

Java program to remove all the occurrences of an object from the arraylist.

import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;

public class ArrayListExample 
{
    public static void main(String[] args) throws CloneNotSupportedException 
    {
        ArrayList<String> alphabets = new ArrayList<>(Arrays.asList("A", "B", "A", "D", "A"));
        
        System.out.println(alphabets);
        
        alphabets.removeAll(Collections.singleton("A"));
        
        System.out.println(alphabets);
    }
}

Program output.

[A, B, A, D, A]
[B, D]

3. ArrayList remove(int index) example

Java program to remove an object by its index position from an arraylist using remove() method.

import java.util.ArrayList;
import java.util.Arrays;

public class ArrayListExample 
{
    public static void main(String[] args) throws CloneNotSupportedException 
    {
        ArrayList<String> alphabets = new ArrayList<>(Arrays.asList("A", "B", "C", "D"));
        
        System.out.println(alphabets);
        
        alphabets.remove("2");          //Index in range
        
        System.out.println(alphabets);
        
        alphabets.remove(10);          //Index out of range
    }
}

Program output.

[A, B, C, D]
Exception in thread "main" java.lang.IndexOutOfBoundsException: Index: 10, Size: 4
	at java.util.ArrayList.rangeCheck(ArrayList.java:653)
	at java.util.ArrayList.remove(ArrayList.java:492)
	at com.howtodoinjava.example.ArrayListExample.main(ArrayListExample.java:18)

That’s all for the ArrayList remove() method in Java.

Happy Learning !!

Read More:

A Guide to Java ArrayList
ArrayList Java Docs