Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

System.arraycopy — copiare un intervallo di array

System.arraycopy copia elementi in un array esistente. Supporta intervalli sovrapposti, ma richiede tipi compatibili e limiti validi.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

System.arraycopy(src, srcPos, dest, destPos, length);

System.arraycopy copia length elementi da src, a partire da srcPos, nell’array esistente dest, a partire da destPos. Restituisce void e non crea un nuovo array.

Gli intervalli sovrapposti funzionano come se si usasse una memoria temporanea. Vengono copiati i valori, incluse le referenze, non gli oggetti stessi.

I tipi primitivi devono corrispondere esattamente. null causa una NullPointerException; limiti non validi o una lunghezza negativa causano una IndexOutOfBoundsException. Argomenti che non sono array o tipi incompatibili causano una ArrayStoreException.

Un elemento di riferimento incompatibile può lasciare già copiati gli elementi precedenti; gli errori di limite e le incompatibilità tra categorie di array lasciano invariata la destinazione.

Esempi

public class Main {
    public static void main(String[] args) {
        int[] values = {1, 2, 3, 4};
        System.arraycopy(values, 0, values, 1, 3);
        for (int value : values) {
            System.out.println(value);
        }
    }
}

Risultato

1
1
2
3

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti