java arraycopy

arraycopy

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。