public static void arraycopy(Object src, int srcPos, Object dest, int destPos, int length)
src
to the destination array referenced by
dest
. The number of components copied is equal to the
length
argument. The components at positions
srcPos
through
srcPos+length-1
in the source array are copied into positions
destPos
through
destPos+length-1
, respectively, of the destination array.
If the src
and dest
arguments refer to the same array object, then the copying is performed as if the components at positions srcPos
through srcPos+length-1
were first copied to a temporary array with length
components and then the contents of the temporary array were copied into positions destPos
through destPos+length-1
of the destination array.
If dest
is null
, then a NullPointerException
is thrown.
If src
is null
, then a NullPointerException
is thrown and the destination array is not modified.
Otherwise, if any of the following is true, an ArrayStoreException
is thrown and the destination is not modified:
- The
src
argument refers to an object that is not an array. - The
dest
argument refers to an object that is not an array. - The
src
argument anddest
argument refer to arrays whose component types are different primitive types. - The
src
argument refers to an array with a primitive component type and thedest
argument refers to an array with a reference component type. - The
src
argument refers to an array with a reference component type and thedest
argument refers to an array with a primitive component type.
Otherwise, if any of the following is true, an IndexOutOfBoundsException
is thrown and the destination is not modified:
- The
srcPos
argument is negative. - The
destPos
argument is negative. - The
length
argument is negative. srcPos+length
is greater thansrc.length
, the length of the source array.destPos+length
is greater thandest.length
, the length of the destination array.
Otherwise, if any actual component of the source array from position srcPos
through srcPos+length-1
cannot be converted to the component type of the destination array by assignment conversion, an ArrayStoreException
is thrown. In this case, let k be the smallest nonnegative integer less than length such that src[srcPos+
k]
cannot be converted to the component type of the destination array; when the exception is thrown, source array components from positions srcPos
through srcPos+
k-1
will already have been copied to destination array positions destPos
through destPos+
k-1
and no other positions of the destination array will have been modified. (Because of the restrictions already itemized, this paragraph effectively applies only to the situation where both arrays have component types that are reference types.)
-
Parameters:
-
src
- the source array. -
srcPos
- starting position in the source array. -
dest
- the destination array. -
destPos
- starting position in the destination data. -
length
- the number of array elements to be copied.
Throws:
-
IndexOutOfBoundsException
- if copying would cause access of data outside array bounds. -
ArrayStoreException
- if an element in thesrc
array could not be stored into thedest
array because of a type mismatch.NullPointerException
- if eithersrc
ordest
isnull
.
自己刚好学习到Java基础里的数组,里面有个九宫格例子,有System. arraycopy()函数,就查看了文档,
逼着自己去看英文版的,看不太懂,然后又对照中文版的,渐渐明白文档的意思。
里面涉及五个参数,源数组,源数组起始复制的位置,目标数组,复制到目标数组开始的位置,复制的长度。
public static void arraycopy(Object src, int srcPos, Object dest, int destPos, int length)
src
- the source array.srcPos
- starting position in the source array.dest
- the destination array.destPos
- starting position in the destination data.length
- the number of array elements to be copied.有三种异常 一种是超出长度,一种是复制的数据类型不匹配,还有一种是目标数组或源数组为空
网上看到一维数组和二维数组复制的时候可能有区别,具体什么区别,搞清楚了再写