Java Utility Library

Java Collections - checkedList() Method



The java.util.Collections.checkedList() method returns a dynamically typesafe view of the specified list. Any attempt to insert an element of the wrong type will result in an immediate ClassCastException.

Syntax

public static <E> List<E> checkedList(List<E> list,
                                      Class<E> type)

Here, E is the type of element in the list.


Parameters

list Specify the list for which a dynamically typesafe view is to be returned.
type Specify the type of element that list is permitted to hold.

Return Value

Returns a dynamically typesafe view of the specified list.

Exception

NA.

Example:

In the example below, the java.util.Collections.checkedList() method returns a dynamically typesafe view of the given list.

import java.util.*;

public class MyClass {
  public static void main(String[] args) {
    //creating a list object
    List<Integer> MyList = new ArrayList<Integer>();

    //populating the list
    MyList.add(10);
    MyList.add(20);
    MyList.add(30);
    MyList.add(40);

    //printing the list
    System.out.println("MyList contains: " + MyList); 

    //creating a dynamically typesafe view
    //of the list
    List NewList = Collections.checkedList(MyList, Integer.class);

    //printing the list
    System.out.println("NewList contains: " + NewList);   
  }
}

The output of the above code will be:

MyList contains: [10, 20, 30, 40]
NewList contains: [10, 20, 30, 40]

❮ Java.util - Collections