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.