KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

System.arraycopy — een arraybereik kopiëren

System.arraycopy kopieert elementen naar een bestaande array. Overlappende bereiken worden ondersteund, maar de typen moeten compatibel zijn en de grenzen geldig.

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

Syntax

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

System.arraycopy kopieert length elementen uit src, vanaf srcPos, naar de bestaande array dest, vanaf destPos. De methode retourneert void en maakt geen nieuwe array aan.

Overlappende bereiken werken alsof er tijdelijke opslag wordt gebruikt. Waarden, waaronder verwijzingen, worden gekopieerd — niet de objecten zelf.

Primitieve typen moeten exact overeenkomen. null veroorzaakt een NullPointerException; ongeldige grenzen of een negatieve lengte veroorzaken een IndexOutOfBoundsException. Argumenten die geen arrays zijn of incompatibele typen veroorzaken een ArrayStoreException.

Bij een incompatibel referentie-element kunnen eerdere elementen al zijn gekopieerd; grensfouten en verschillen in arraycategorie laten de bestemming ongewijzigd.

Voorbeelden

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);
        }
    }
}

Resultaat

1
1
2
3

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen