Collections.nCopies() in Java

The role of Collections.nCopies() is to return an immutable list which contains n copies of given object. This function helps if we want to create a list with n copies of given object. The newly allocated data object is tiny i.e, it contains a single reference to the data object.

Syntax :

public static <T> List<T> nCopies(int number, T object)

where, number is the number of copies
of object and object represents the 
element which will appear number times
in the returned list. T represents generic type. 

Exception : The function throws IllegalArgumentException if value of number is less than 0.

Example :






// Java code to show implementation
// of Collections.nCopies()
import java.util.*;
class GFG {
    // Driver code
    public static void main(String[] args)
        // creating a list where first argument
        // represents the number of copies and
        // the second argument represents the
        // element to be copied for 'number' times
        // This will create 4 copies of the objects.
        List list = Collections.nCopies(4, "GeeksforGeeks");
        // Displaying the list returned
        System.out.println("The list returned is :");
        Iterator itr = list.iterator();
        while (itr.hasNext()) {
            System.out.print( + " ");
        List list1 = Collections.nCopies(3, "GeeksQuiz");
        // Displaying the list returned
        System.out.println("The list returned is :");
        Iterator itr1 = list1.iterator();  
        while (itr1.hasNext()) {
            System.out.print( + " ");


Output :

The list returned is :
GeeksforGeeks GeeksforGeeks GeeksforGeeks GeeksforGeeks 

The list returned is :
GeeksQuiz GeeksQuiz GeeksQuiz  

My Personal Notes arrow_drop_up

In love with a semicolon because sometimes i miss it so badly)

If you like GeeksforGeeks and would like to contribute, you can also write an article using or mail your article to See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.

Article Tags :
Practice Tags :


Please write to us at to report any issue with the above content.