Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

System.arraycopy — kopírovanie časti poľa

System.arraycopy kopíruje prvky do existujúceho poľa. Podporuje prekrývajúce sa rozsahy, ale vyžaduje kompatibilné typy a platné hranice.

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

Syntax

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

System.arraycopy kopíruje length prvkov z src od indexu srcPos do existujúceho poľa dest od indexu destPos. Vracia void a nevytvára nové pole.

Prekrývajúce sa rozsahy fungujú, akoby sa použilo dočasné úložisko. Kopírujú sa hodnoty vrátane referencií, nie samotné objekty.

Primitívne typy sa musia presne zhodovať. null spôsobí NullPointerException; neplatné hranice alebo záporná dĺžka spôsobia IndexOutOfBoundsException. Argumenty, ktoré nie sú polia, alebo nekompatibilné typy spôsobia ArrayStoreException.

Nekompatibilný referenčný prvok môže spôsobiť, že predchádzajúce prvky už budú skopírované; chyby hraníc a nezhoda kategórií polí cieľ nezmenia.

Prí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ýsledok

1
1
2
3

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje