CKTIS / Java
System.arraycopy — kopírování části pole
System.arraycopy kopíruje prvky do existujícího pole. Podporuje překrývající se rozsahy, ale vyžaduje kompatibilní typy a platné meze.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
System.arraycopy(src, srcPos, dest, destPos, length);System.arraycopy kopíruje length prvků z src od indexu srcPos do existujícího pole dest od indexu destPos. Vrací void a nevytváří nové pole.
Překrývající se rozsahy fungují, jako by se použilo dočasné úložiště. Kopírují se hodnoty, včetně referencí, nikoli samotné objekty.
Primitivní typy se musí přesně shodovat. null způsobí NullPointerException; neplatné meze nebo záporná délka způsobí IndexOutOfBoundsException. Argumenty, které nejsou pole, nebo nekompatibilní typy způsobí ArrayStoreException.
Nekompatibilní referenční prvek může způsobit, že předchozí prvky už budou zkopírovány; chyby mezí a neshoda kategorií polí cíl nezmění.
Příklady
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);
}
}
}Výsledek
1 1 2 3
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.