public static void arraycopy(Object src, int srcPos, Object dest, int destPos, int length)
-
从指定源数组中复制一个数组,复制从指定的位置开始,到目标数组的指定位置结束。从
src
引用的源数组到dest
引用的目标数组,数组组件的一个子序列被复制下来。被复制的组件的编号等于length
参数。源数组中位置在srcPos
到srcPos+length-1
之间的组件被分别复制到目标数组中的destPos
到destPos+length-1
位置。如果参数
src
和dest
引用相同的数组对象,则复制的执行过程就好像首先将srcPos
到srcPos+length-1
位置的组件复制到一个带有length
组件的临时数组,然后再将此临时数组的内容复制到目标数组的destPos
到destPos+length-1
位置一样。If 如果
dest
为null
,则抛出NullPointerException
异常。如果
src
为null
, 则抛出NullPointerException
异常,并且不会修改目标数组。否则,只要下列任何情况为真,则抛出
ArrayStoreException
异常并且不会修改目标数组:src
参数指的是非数组对象。dest
参数指的是非数组对象。src
参数和dest
参数指的是那些其组件类型为不同基本类型的数组。src
参数指的是具有基本组件类型的数组且dest
参数指的是具有引用组件类型的数组。src
参数指的是具有引用组件类型的数组且dest
参数指的是具有基本组件类型的数组。
否则,只要下列任何情况为真,则抛出
IndexOutOfBoundsException
异常,并且不会修改目标数组:srcPos
参数为负。destPos
参数为负。length
参数为负。srcPos+length
大于src.length
,即源数组的长度。destPos+length
大于dest.length
,即目标数组的长度。
否则,如果源数组中
srcPos
到srcPos+length-1
位置上的实际组件通过分配转换并不能转换成目标数组的组件类型,则抛出ArrayStoreException
异常。在这种情况下,将 k 设置为比长度小的最小非负整数,这样就无法将src[srcPos+
k]
转换为目标数组的组件类型;当抛出异常时,从srcPos
到srcPos+
k-1
位置上的源数组组件已经被复制到目标数组中的destPos
到destPos+
k-1
位置,而目标数组中的其他位置不会被修改。(因为已经详细说明过的那些限制,只能将此段落有效地应用于两个数组都有引用类型的组件类型的情况。) -
-
参数:
-
src
- 源数组。 -
srcPos
- 源数组中的起始位置。 -
dest
- 目标数组。 -
destPos
- 目标数据中的起始位置。 -
length
- 要复制的数组元素的数量。
抛出:
-
IndexOutOfBoundsException
- 如果复制会导致对数组范围以外的数据的访问。 -
ArrayStoreException
- 如果因为类型不匹配而使得无法将src
数组中的元素存储到dest
数组中。 -
NullPointerException
- 如果src
或dest
为null
。
-
public class CopyArray {
public static void main(String[] args) {
int elements[] = { 1, 2, 3, 4, 5, 6 };
int hold[] = { 10, 9, 8, 7, 6, 5, 4, 3, 2, 1 };
int result[] = new int[16];
//数组累加
System.arraycopy(elements, 0, result, 0, elements.length);
System.arraycopy(hold, 0, result, elements.length, hold.length);
for (int i = 0; i < result.length; i++)
System.out.println("result[" + i + "]=" + result[i]);
//自复制
System.arraycopy(elements, 0, elements, 0, elements.length);
for (int i = 0; i < elements.length; i++)
System.out.println("elements[" + i + "]=" + elements[i]);
//覆盖累加
System.arraycopy(elements, 0, hold, 0, elements.length);
for (int i = 0; i < hold.length; i++)
System.out.println("hold[" + i + "]=" + hold[i]);
}
}