Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje