Автор оригинала: Pankaj Kumar.
Java System.arraycopy () – это собственный статический метод для копирования элементов из исходного массива в целевой массив.
Аргументы метода System.arraycopy()
Сигнатура метода System.arraycopy() является:
public static native void arraycopy(Object src, int srcPos, Object dest, int destPos, int length);
- src : исходный массив.
- srcPos : индекс исходного массива, с которого начнется копирование
- dest : массив назначения.
- destPos : индекс массива назначения, из которого будут скопированы данные.
- длина : количество элементов для копирования.
Пример Java System.arraycopy()
Давайте рассмотрим простой пример копирования массива с помощью этого метода.
package com.journaldev.examples; import java.util.Arrays; public class SystemArrayCopy { public static void main(String[] args) { int[] source = { 1, 2, 3, 4, 5, 6, 7 }; int[] destination = new int[5]; System.arraycopy(source, 3, destination, 2, 3); System.out.println(Arrays.toString(destination)); } }
Выход
Пример Java System.arraycopy()
Элементы из исходного массива для копирования равны 4,5,6. Они копируются в целевой массив, начиная с индекса 2.
System.arraycopy (), когда источник и назначение являются одним и тем же массивом
Если источником и назначением являются одни и те же массивы, из исходного массива создается временный массив. Затем элементы из временного массива копируются в исходный массив.
jshell> int[] source = { 1, 2, 3, 4, 5, 6, 7 }; source ==> int[7] { 1, 2, 3, 4, 5, 6, 7 } jshell> System.arraycopy(source, 3, source, 5, 2); jshell> System.out.println(Arrays.toString(source)); [1, 2, 3, 4, 5, 4, 5]
Сценарии исключений с помощью системного метода arraycopy()
Метод arraycopy() имеет 5 аргументов. Таким образом, существует множество случаев, когда может возникнуть исключение. Исключения, создаваемые этим методом, следующие:
- Исключение NullPointerException : если исходный или целевой массив равен нулю.
- Исключение ArrayStoreException : если тип массива источника и назначения не совпадает или они не являются массивом.
- Исключение ArrayIndexOutOfBoundsException : если переполнение данных происходит из-за значений индекса или они отрицательные.
Давайте рассмотрим некоторые примеры этих сценариев исключений.
1. Примеры исключений NullPointerException
jshell> System.arraycopy(source, 3, null, 2, 3); | Exception java.lang.NullPointerException | at System.arraycopy (Native Method) | at (#4:1) jshell> System.arraycopy(null, 3, source, 2, 3); | Exception java.lang.NullPointerException | at System.arraycopy (Native Method) | at (#5:1)
2. Исключение ArrayStoreException, когда источник и назначение не являются массивом
jshell> System.arraycopy(new Object(), 3, source, 2, 3); | Exception java.lang.ArrayStoreException: arraycopy: source type java.lang.Object is not an array | at System.arraycopy (Native Method) | at (#6:1) jshell> System.arraycopy(source, 3, "ABC", 2, 3); | Exception java.lang.ArrayStoreException: arraycopy: destination type java.lang.String is not an array | at System.arraycopy (Native Method) | at (#7:1)
3. Исключение ArrayStoreException, когда массивы источника и назначения несовместимы
jshell> int[] source = {1, 2, 3} source ==> int[3] { 1, 2, 3 } jshell> String[] destination = new String[5]; destination ==> String[5] { null, null, null, null, null } jshell> System.arraycopy(source, 0, destination, 0, 2); | Exception java.lang.ArrayStoreException: arraycopy: type mismatch: can not copy int[] into object array[] | at System.arraycopy (Native Method) | at (#10:1)
4. Исключение ArrayIndexOutOfBoundsException, когда индекс или длина отрицательны
jshell> int[] source = {1, 2, 3} source ==> int[3] { 1, 2, 3 } jshell> int[] dest = new int[5]; dest ==> int[5] { 0, 0, 0, 0, 0 } jshell> System.arraycopy(source, -1, dest, 0, 2); | Exception java.lang.ArrayIndexOutOfBoundsException: arraycopy: source index -1 out of bounds for int[3] | at System.arraycopy (Native Method) | at (#15:1) jshell> System.arraycopy(source, 1, dest, -1, 2); | Exception java.lang.ArrayIndexOutOfBoundsException: arraycopy: destination index -1 out of bounds for int[5] | at System.arraycopy (Native Method) | at (#16:1) jshell> System.arraycopy(source, 1, dest, 0, -2); | Exception java.lang.ArrayIndexOutOfBoundsException: arraycopy: length -2 is negative | at System.arraycopy (Native Method) | at (#17:1)
5. Исключение ArrayIndexOutOfBoundsException, когда srcPos+длина больше, чем src.длина
jshell> System.arraycopy(source, 0, dest, 0, 4); | Exception java.lang.ArrayIndexOutOfBoundsException: arraycopy: last source index 4 out of bounds for int[3] | at System.arraycopy (Native Method) | at (#18:1)
6. Исключение ArrayIndexOutOfBoundsException, когда destPos+длина больше, чем dest.длина
jshell> int[] src = {1, 2, 3, 4} src ==> int[4] { 1, 2, 3, 4 } jshell> int[] dest = new int[2] dest ==> int[2] { 0, 0 } jshell> System.arraycopy(src, 0, dest, 0, 3); | Exception java.lang.ArrayIndexOutOfBoundsException: arraycopy: last destination index 3 out of bounds for int[2] | at System.arraycopy (Native Method) | at (#21:1)
Вывод
Для копирования элементов массива можно использовать собственный метод Java System arraycopy (). Однако существует множество сценариев, которые могут привести к исключениям во время выполнения. Поэтому вам следует использовать его осторожно, когда вы знаете длину исходного и целевого массива.