JavaSystem.Arraycopy(Object, Int32, Object, Int32, Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Copia una matrice dalla matrice di origine specificata, a partire dalla posizione specificata, nella posizione specificata della matrice di destinazione.
[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
Parametri
- src
- Object
matrice di origine.
- srcPos
- Int32
posizione iniziale nella matrice di origine.
- dest
- Object
matrice di destinazione.
- destPos
- Int32
posizione iniziale nei dati di destinazione.
- length
- Int32
numero di elementi della matrice da copiare.
- Attributi
Commenti
Copia una matrice dalla matrice di origine specificata, a partire dalla posizione specificata, nella posizione specificata della matrice di destinazione. Una sottosequenza dei componenti della matrice viene copiata dalla matrice di origine a cui src fa riferimento la matrice di destinazione a cui fa destriferimento . Il numero di componenti copiati è uguale all'argomento length . I componenti in corrispondenza delle posizioni srcPossrcPos+length-1 nella matrice di origine vengono copiati rispettivamente in posizioni destPos tramite destPos+length-1, rispettivamente, della matrice di destinazione.
Se gli src argomenti e dest fanno riferimento allo stesso oggetto matrice, la copia viene eseguita come se i componenti in corrispondenza delle posizioni srcPossrcPos+length-1 attraverso siano stati copiati per la prima volta in una matrice temporanea con length componenti e quindi il contenuto della matrice temporanea è stato copiato in posizioni destPos attraverso destPos+length-1 la matrice di destinazione.
Se dest è null, viene generata un'eccezione NullPointerException .
Se src è null, viene generata un'eccezione NullPointerException e la matrice di destinazione non viene modificata.
In caso contrario, se uno dei seguenti è true, viene generata un'eccezione ArrayStoreException e la destinazione non viene modificata: <ul><li>L'argomento src fa riferimento a un oggetto che non è una matrice.
<li>L'argomento dest fa riferimento a un oggetto che non è una matrice.
<li>L'argomento e src l'argomento dest fanno riferimento a matrici i cui tipi di componente sono tipi primitivi diversi.
<li>L'argomento src fa riferimento a una matrice con un tipo di componente primitivo e l'argomento dest fa riferimento a una matrice con un tipo di componente di riferimento.
<li>L'argomento src fa riferimento a una matrice con un tipo di componente di riferimento e l'argomento dest fa riferimento a una matrice con un tipo di componente primitivo.
</ul>
In caso contrario, se uno dei seguenti è true, viene generata un'eccezione IndexOutOfBoundsException e la destinazione non viene modificata: <ul><li>L'argomento srcPos è negativo.
<li>L'argomento destPos è negativo.
<li>L'argomento length è negativo.
<li>srcPos+length è maggiore di src.length, la lunghezza della matrice di origine.
<li>destPos+length è maggiore di dest.length, la lunghezza della matrice di destinazione.
</ul>
In caso contrario, se un componente effettivo della matrice di origine dalla posizione srcPos tramite srcPos+length-1 non può essere convertito nel tipo di componente della matrice di destinazione mediante la conversione dell'assegnazione, viene generata un'eccezione ArrayStoreException . In questo caso, lasciare <che b>/b<> sia il numero intero non negativo più piccolo di lunghezza inferiore alla lunghezza, in modo che src[srcPos+k] non possa essere convertito nel tipo di componente della matrice di destinazione. Quando viene generata l'eccezione, i componenti della matrice di origine da posizioni srcPos fino srcPos+ a k-1 saranno già stati copiati nelle posizioni destPos della matrice di destinazione fino destPos+ a k-1 e non saranno state modificate altre posizioni della matrice di destinazione. A causa delle restrizioni già elencate, questo paragrafo si applica in modo efficace solo alla situazione in cui entrambe le matrici hanno tipi di componenti che sono tipi riferimento.
per java.lang.System.arraycopy(java.lang.Object, int, java.lang.Object, int, int).
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.