概述:
System.arraycopy是一个原生的方法,用于数组间的复制,当然延伸功能完成数组替换。
1、翻译Java源码的注释
public static native void arraycopy(Object src, int srcPos, Object dest, int destPos, int length);
@param src 原数组
* @param srcPos 原数组开始位置
* @param dest 目标数组
* @param destPos 目标数组开始位置.
* @param length 复制的长度
* @exception IndexOutOfBoundsException 数组越界
* @exception ArrayStoreException 类型不匹配
* @exception NullPointerException 原数组或目标数组为Null
从原数组特定位置复制数据到目标数组的特定位置,(简单就是数组之间复制),这里说的原数组在方法参数代表是src,目标数组为dest,原数组特定位置方法参数是srcPos,目标数组特定位置为destPos, 复制的长度为length。
举个例子
byte[] originalBytes={1,2,3,4,5,6};
byte[] targetBytes = {7,8,9};
System.arraycopy(originalBytes, 2, targetBytes , 0, 3);
结果为:
target:[3, 4, 5]
注意复制数据不要大于目标数组的长度,原数组数据偏移过后长度必须满足需要复制的长度,否则抛出数组越界异常
继续翻译:
如果原数组和目标数组是一个相同的数组,那么它会先将需要复制的内容复制到一个临时数组中,然后再将临时数组复制该数组中,中间增加一个临时变量。
以下是异常相关:
如果目标数组为null将会抛出NullPointerException
如果原数组为null将会抛出NullPointerException,目标数组不会修改。
以下条件满足将会抛出ArrayStoreException,且目标数组不会改变:
- 1、原数组或目标数组引用的对象不是数组类型
- 2、原数组和目标数组的原生类型不一样,比如原数组是int,目标数组是double类型
- 3、原数组引用的是原生类型,而目标数组引用是引用类型,比如原数组是int 目标数组是某个对象的引用, 反之也不行
以下条件满足将会抛出IndexOutOfBoundsException,且目标数组不会改变:
- 1、srcPos或destPos或length 为负数
- 2、srcPos+length 大于 src.length ,或者 destPos+length 大于 dest.length
2、例子完成byte数组替换
/**
* 字节数组替换
* @param originalBytes 需要替换原数组
* @param offset 原数组偏移位置
* @param len 原数组替换的长度 (替换原数组旧内容offset 到len)
* @param replaceBytes 目标数组(替换新的内容)
* @return
*/
public static byte[] bytesReplace(byte[] originalBytes, int offset, int len, byte[] replaceBytes) {
byte[] newBytes = new byte[originalBytes.length + (replaceBytes.length - len)];
System.arraycopy(originalBytes, 0, newBytes, 0, offset);
System.arraycopy(replaceBytes, 0, newBytes, offset, replaceBytes.length);
System.arraycopy(originalBytes, offset + len, newBytes, offset+replaceBytes.length, originalBytes.length - offset -len);
return newBytes;
}