java.util.Collections.ncopies() Method

---

Description

The ncopies(int, T) method is used to returns an immutable list consisting of n copies of the specified object.

Declaration

Following is the declaration for java.util.Collections.ncopies() method.

public static <T> List<T> nCopies(int n, T o)

Parameters

• n − The number of elements in the returned list.

• o − The element to appear repeatedly in the returned list.

Return Value

The method call returns an immutable list consisting of n copies of the specified object.

Exception

IllegalArgumentException − This is thrown if n < 0.

Example

The following example shows the usage of java.util.Collections.ncopies()

package com.tutorialspoint;

import java.util.*;

public class CollectionsDemo {
   public static void main(String[] args) {
      
      // create a list with n copies 
      List list = Collections.nCopies(5, "tuitorial Point");

      // create an iterator
      Iterator itr = list.iterator();

      System.out.println("Values are :");
      while (itr.hasNext()) {
         System.out.println(itr.next());
      }
   }      
}

Let us compile and run the above program, this will produce the following result.

Values are :
tuitorial Point
tuitorial Point
tuitorial Point
tuitorial Point
tuitorial Point