Java Collections emptyList() Method

The emptyList() method of Java Collections class is used to get a List that has no elements. These empty list are immutable in nature.

Syntax

Following is the declaration of emptyList() method:

Parameter

This method does not accept any parameter.

Returns

The emptyList() method returns an empty immutable list.

Exceptions

Compatibility Version

Java 1.5 and above

Example 1

import java.util.*;
public class CollectionsEmptyListExample1 {
	public static void main(String[] args) {		
	     //Create an empty List    
	     List<String> EmptyList = Collections.<String>emptyList();
	     System.out.println("Empty list: "+EmptyList);
	     }	  
}

Test it Now

Output:

Empty list: []

Example 2

import java.util.*;
public class CollectionsEmptyListExample2 {
	public static void main(String[] args) {		
		//Create an empty List  
	      List<String> emptylist = Collections.emptyList();
	      System.out.println("Created empty immutable list: "+emptylist);
	      //Try to add elements
	      emptylist.add("A");
	      emptylist.add("B");
	      }	  
}

Test it Now

Output:

Created empty immutable list: []
Exception in thread "main" java.lang.UnsupportedOperationException
	at java.base/java.util.AbstractList.add(AbstractList.java:153)
	at java.base/java.util.AbstractList.add(AbstractList.java:111)
	at myPackage.CollectionsEmptyListExample1.main(CollectionsEmptyListExample1.java:9)

Example 3

import java.util.*;
public class CollectionsEmptyListExample3 {
	public static void main(String[] args) {		
		//Create an empty List    
	      List<Integer> empList = Collections.emptyList();
	      empList.add(1);
	      empList.add(2);    
	      System.out.println("Created empty immutable List: "+empList);	     
	      }	  
}

Test it Now

Output:

Exception in thread "main" java.lang.UnsupportedOperationException
	at java.base/java.util.AbstractList.add(AbstractList.java:153)
	at java.base/java.util.AbstractList.add(AbstractList.java:111)
	at myPackage.CollectionsEmptyListExample3.main(CollectionsEmptyListExample3.java:8)

Next TopicJava Collections Class

← prev next →