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。