WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

System.arraycopy — einen Arraybereich kopieren

System.arraycopy kopiert Elemente in ein vorhandenes Array. Überlappende Bereiche werden unterstützt; die Typen müssen kompatibel und die Grenzen gültig sein.

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

Syntax

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

System.arraycopy kopiert length Elemente aus src ab srcPos in das vorhandene Array dest ab destPos. Die Methode gibt void zurück und erstellt kein neues Array.

Überlappende Bereiche funktionieren, als würde temporärer Speicher verwendet. Kopiert werden Werte, einschließlich Referenzen, nicht die Objekte selbst.

Primitive Typen müssen exakt übereinstimmen. null verursacht eine NullPointerException; ungültige Grenzen oder eine negative Länge verursachen eine IndexOutOfBoundsException. Argumente, die keine Arrays sind, oder inkompatible Typen verursachen eine ArrayStoreException.

Bei einem inkompatiblen Referenzelement können frühere Elemente bereits kopiert worden sein; Grenzfehler und nicht übereinstimmende Arraykategorien lassen das Ziel unverändert.

Beispiele

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

Ergebnis

1
1
2
3

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen