This method creates a copy of elements, within a specified range of the original array.
Syntax :
public static int[] copyOfRange(int[] original_array, int from_index, int to_index)
- original_array : Array to be copied from
- from_index : Starting index of range to be copied
- to_end : the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Important points to remember while working with this method :
- The initial index i.e(from_index) must lie within 0 to original_array.length
- The final index i.e(to_index) can be greater than or equal to length of original array. In case it is greater than the original Array then 0’s is assigned to the copy whose index is greater than or equal to original.length – from.
- Return array has length of will be to-from
- Its a method of Arrays class
Exceptions
-
ArrayIndexOutOfBoundsException : This is thrown if the initial index i.e(from_index)
is out of range of original array - IllegalArgumentException : This is thrown if from_index>to_index
- NullPointerException : This is thrown if the original array is null
Variations:
copyOfRange(boolean[] original, int from, int to) copyOfRange(byte[] original, int from, int to) copyOfRange(char[] original, int from, int to) copyOfRange(double[] original, int from, int to) copyOfRange(float[] original, int from, int to) copyOfRange(int[] original, int from, int to) copyOfRange(long[] original, int from, int to) copyOfRange(short[] original, int from, int to) copyOfRange(T[] original, int from, int to) copyOfRange(U[] original, int from, int to, Class newType)
Let’s understand this by an example:
// Java program to illustrate // copyOfRange method import java.util.Arrays;
class GFG {
public static void main(String args[])
{
int arr[] = { 12 , 13 , 14 , 15 , 16 , 17 , 18 };
// to index is within the range
int [] copy = Arrays.copyOfRange(arr, 2 , 6 );
for ( int i : copy)
System.out.print(i + " " );
System.out.println();
// to index is out of range
// It assigns Zero to all the index out of range
int [] copy1 = Arrays.copyOfRange(arr, 4 , arr.length + 3 );
for ( int i : copy1)
System.out.print(i + " " );
// It throws IllegalArgumentException
// int[] copy2 = Arrays.copyOfRange(arr, 5, 3);
// It throws ArrayIndexOutOfBoundsException
// int[] copy2 = Arrays.copyOfRange(arr, 10, arr.length + 5);
}
} |
Output:
14 15 16 17 16 17 18 0 0 0
Lets see an Example for copyOfRange(T[] original, int from, int to) and copyOfRange(U[] original, int from, int to, Class newType)
// Java program to illustrate // copyOfRange method import java.util.Arrays;
class GFG {
// User defined class
static class Employee {
int Eid;
String Ename;
// constructor
public Employee( int Eid, String Ename)
{
this .Eid = Eid;
this .Ename = Ename;
}
// Override toString()
public String toString()
{
return Eid + " " + Ename;
}
}
public static void
main(String args[])
{
Employee[] e = { new Employee( 10 , "geek1" ),
new Employee( 20 , "geek2" ),
new Employee( 30 , "geek3" ),
new Employee( 40 , "geek4" ),
new Employee( 50 , "geek5" ) };
// Illustration of copyOfRange(T[] original, int from, int to)
// Working with user defined class
Employee[] getCopy_Employees = Arrays.copyOfRange(e, 3 , 5 );
for (Employee e1 : getCopy_Employees)
System.out.print(e1.toString() + " " );
System.out.println();
// Illustration of copyOfRange(U[] original, int from, int to, Class newType)
// In this we store the user defined class Employee into Object class
// It Throws ArrayStoreException when we try to copy it in a class
// That is not correct
Object getcopy[] = Arrays.copyOfRange(e, 1 , 3 , Object[]. class );
// This throws an error
// Number getcopy[] = Arrays.copyOfRange(e, 1, 3, Number[].class);
for (Object e1 : getcopy) {
System.out.print(e1.toString() + " " );
}
}
} |
Output:
40 geek4 50 geek5 20 geek2 30 geek3
copyOf vs copyOfRange
copyOf() starts copying from the 0 th index of the original array and copies the specified number of elements
While copyOfRange() can copy the range of elements from the original array.
Reference :
docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#copyOfRange-int:A-int-int-