言語

JavaSystem.Arraycopy(Object, Int32, Object, Int32, Int32) メソッド

定義

名前空間:
Java.Lang
アセンブリ:
Mono.Android.dll

指定した位置からコピー先の配列の指定した位置に、指定したソース配列から配列をコピーします。

[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

コピーする配列要素の数。

属性
RegisterAttribute

注釈

指定した位置からコピー先の配列の指定した位置に、指定したソース配列から配列をコピーします。 配列コンポーネントのサブシーケンスは、 src によって参照されるソース配列から、 destによって参照されるコピー先配列にコピーされます。 コピーされるコンポーネントの数は、 length 引数と同じです。 ソース配列内のsrcPosを介してsrcPos+length-1位置にあるコンポーネントは、コピー先の配列のdestPosを介してdestPos+length-1位置にコピーされます。

src引数とdest引数が同じ配列オブジェクトを参照している場合、コピーは、srcPosを介してsrcPos+length-1位置にあるコンポーネントが最初にlengthコンポーネントを含む一時配列にコピーされた場合と同様に実行され、その後、一時配列の内容がコピー先配列のdestPosdestPos+length-1位置にコピーされます。

destがnullされている場合は、NullPointerExceptionがスローされます。

srcがnullされている場合、NullPointerExceptionがスローされ、コピー先の配列は変更されません。

それ以外の場合、次のいずれかが true の場合、ArrayStoreExceptionがスローされ、変換先は変更されません:<ul><li>src引数は配列ではないオブジェクトを参照します。 <li>引数 dest 配列ではないオブジェクトを参照します。 <li>src引数とdest引数は、コンポーネント型が異なるプリミティブ型の配列を参照します。 <li>src 引数はプリミティブ コンポーネント型の配列を参照し、dest引数は参照コンポーネント型の配列を参照します。 <li>src引数は参照コンポーネント型の配列を参照し、dest引数はプリミティブ コンポーネント型の配列を参照します。 </ul>

それ以外の場合、次のいずれかが true の場合、 IndexOutOfBoundsException がスローされ、変換先は変更されません: <ul><li>srcPos 引数は負の値です。 <li>引数 destPos 負の値を指定します。 <li>引数 length 負の値を指定します。 <li>srcPos+length がソース配列の長 src.lengthより大きい。 <li>destPos+length は dest.length、コピー先の配列の長さを超えています。 </ul>

それ以外の場合、位置 srcPos から srcPos+length-1 までのソース配列の実際のコンポーネントを代入変換によって変換先配列のコンポーネント型に変換できない場合は、 ArrayStoreException がスローされます。 この場合、<b>k</b>を長さより小さい最小の非負の整数にして、src[srcPos+k]を変換先配列のコンポーネント型に変換できないようにします。 例外がスローされると、srcPosから srcPos+k-1 までの位置からのソース配列コンポーネントは既に、destPosdestPos+ を介して-1コピー先の配列位置にコピーされコピー先配列の他の位置は変更されません。 (この段落は既に項目化されている制限があるため、両方の配列に参照型であるコンポーネント型がある状況にのみ効果的に適用されます)。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象