JavaSystem.Arraycopy(Object, Int32, Object, Int32, Int32) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将指定源数组中的数组从指定位置开始复制到目标数组的指定位置。
[Android.Runtime.Register("arraycopy", "(Ljava/lang/Object;ILjava/lang/Object;II)V", "")]
public static void Arraycopy(Java.Lang.Object src, int srcPos, Java.Lang.Object dest, int destPos, int length);
[<Android.Runtime.Register("arraycopy", "(Ljava/lang/Object;ILjava/lang/Object;II)V", "")>]
static member Arraycopy : Java.Lang.Object * int * Java.Lang.Object * int * int -> unit
参数
- src
- Object
源数组。
- srcPos
- Int32
源数组中的起始位置。
- dest
- Object
目标数组。
- destPos
- Int32
目标数据中的起始位置。
- length
- Int32
要复制的数组元素数。
- 属性
注解
将指定源数组中的数组从指定位置开始复制到目标数组的指定位置。 数组组件的子序列从所引用 src 的源数组复制到所 dest引用的目标数组。 复制的组件数等于 length 参数。 源数组中位置srcPossrcPos+length-1处的组件分别复制到目标数组的位置destPosdestPos+length-1。
如果参数src引用同一数组对象,则复制将执行,就像先将位置destsrcPos上的组件复制到具有srcPos+length-1组件的临时数组,然后将临时数组的内容复制到lengthdestPos目标数组的位置。destPos+length-1
如果是dest,则会引发 anull。NullPointerException
如果是src,则会引发 a null 并未修改目标NullPointerException数组。
否则,如果下列任一项为 true,则会引发一个 ArrayStoreException ,并且目标未修改: <ul><li>参数 src 引用不是数组的对象。
<li>参数 dest 引用不是数组的对象。
<li>参数 src 和 dest 参数是指其组件类型是不同基元类型的数组。
<li>参数 src 引用基元组件类型的数组, dest 参数引用具有引用组件类型的数组。
<li>参数 src 引用具有引用组件类型的数组, dest 参数引用具有基元组件类型的数组。
</ul>
否则,如果以下任一项为 true,则会引发 an IndexOutOfBoundsException ,并且目标未修改: <ul><li>参数 srcPos 为负。
<li>参数 destPos 为负数。
<li>参数 length 为负数。
<li>srcPos+length 大于 src.length源数组的长度。
<li>destPos+length 大于 dest.length目标数组的长度。
</ul>
否则,如果源数组的任何实际组件无法srcPossrcPos+length-1通过赋值转换转换为目标数组的组件类型,则会引发一个ArrayStoreException。 在这种情况下,让 <b>k</b> 是长度小于长度的最小非负整数,以便src[srcPos+无法将 k] 转换为目标数组的组件类型;当引发异常时,通过 srcPossrcPos+ 的位置-1将源数组组件复制到目标数组位置destPosdestPos+-1修改目标数组的其他位置。 (由于已项化的限制,此段落实际上仅适用于两个数组都具有引用类型的组件类型的情况。
适用于 . 的 java.lang.System.arraycopy(java.lang.Object, int, java.lang.Object, int, int)Java 文档
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。