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.