JavaSystem.Arraycopy(Object, Int32, Object, Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Kopiert ein Array aus dem angegebenen Quellarray, beginnend an der angegebenen Position, an die angegebene Position des Zielarrays.
[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
Parameter
- src
- Object
das Quellarray.
- srcPos
- Int32
Startposition im Quellarray.
- dest
- Object
das Zielarray.
- destPos
- Int32
Startposition in den Zieldaten.
- length
- Int32
die Anzahl der zu kopierenden Arrayelemente.
- Attribute
Hinweise
Kopiert ein Array aus dem angegebenen Quellarray, beginnend an der angegebenen Position, an die angegebene Position des Zielarrays. Eine Untermenge der Arraykomponenten wird aus dem Quellarray kopiert, auf das verwiesen src wird, in das Zielarray, auf das verwiesen wird dest. Die Anzahl der kopierten Komponenten entspricht dem length Argument. Die Komponenten an Positionen srcPos im srcPos+length-1 Quellarray werden über das Zielarray in destPosPositionen destPos+length-1 kopiert.
Wenn sich die srcdest Argumente auf dasselbe Arrayobjekt beziehen, wird das Kopieren so ausgeführt, als würden die Komponenten an Positionen srcPos zuerst srcPos+length-1 in ein temporäres Array mit length Komponenten kopiert und dann der Inhalt des temporären Arrays in Positionen destPos über destPos+length-1 das Zielarray kopiert.
Wenn dest ja null, wird ein NullPointerException Wurf ausgelöst.
Wenn src ja null, wird ein NullPointerException Fehler ausgelöst, und das Zielarray wird nicht geändert.
Andernfalls wird eine ArrayStoreException der folgenden Werte ausgelöst, und das Ziel wird nicht geändert: <ul><li>Das src Argument bezieht sich auf ein Objekt, das kein Array ist.
<li>Das dest Argument bezieht sich auf ein Objekt, das kein Array ist.
<li>Das src Argument und dest das Argument beziehen sich auf Arrays, deren Komponententypen unterschiedliche Grundtypen sind.
<li>The src argument refers to an array with a primitive component type and the dest argument refers to an array with a reference component type.
<li>Das src Argument bezieht sich auf ein Array mit einem Verweiskomponententyp und das dest Argument bezieht sich auf ein Array mit einem primitiven Komponententyp.
</ul>
Andernfalls wird eine IndexOutOfBoundsException der folgenden Werte ausgelöst, und das Ziel wird nicht geändert: <ul><li>Das srcPos Argument ist negativ.
<li>Das destPos Argument ist negativ.
<li>Das length Argument ist negativ.
<li>srcPos+length ist größer als src.length, die Länge des Quellarrays.
<li>destPos+length ist größer als dest.length, die Länge des Zielarrays.
</ul>
Andernfalls wird ein srcPos Auslösen ausgelöst, wenn eine tatsächliche Komponente des Quellarrays von position srcPos+length-1 aus ArrayStoreException nicht in den Komponententyp des Zielarrays durch Zuweisungskonvertierung konvertiert werden kann. Lassen Sie <in diesem Fall b></b> die kleinste nichtnegative ganze Zahl kleiner als die Länge sein, src[srcPos+ sodass k] nicht in den Komponententyp des Zielarrays konvertiert werden kann. Wenn die Ausnahme ausgelöst wird, wurden Quellarraykomponenten von Positionen srcPos bis srcPos+k-1 bereits in Zielarraypositionen destPos über destPos+k-1 kopiert, und keine anderen Positionen des Zielarrays wurden geändert. (Aufgrund der bereits aufgeführten Einschränkungen gilt dieser Absatz effektiv nur für die Situation, in der beide Arrays Komponententypen haben, die Referenztypen sind.)
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.