CKTIS / Java
System.arraycopy — kopiranje dela polja
System.arraycopy kopira elemente v obstoječe polje. Podpira prekrivajoča se območja, vendar zahteva združljive tipe in veljavne meje.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
System.arraycopy(src, srcPos, dest, destPos, length);System.arraycopy kopira length elementov iz src od indeksa srcPos v obstoječe polje dest od indeksa destPos. Vrne void in ne ustvari novega polja.
Prekrivajoča se območja delujejo, kot da bi uporabili začasni pomnilnik. Kopirajo se vrednosti, tudi reference, ne pa sami objekti.
Primitivni tipi se morajo natančno ujemati. null povzroči NullPointerException; neveljavne meje ali negativna dolžina povzročijo IndexOutOfBoundsException. Argumenti, ki niso polja, ali nezdružljivi tipi povzročijo ArrayStoreException.
Nezdružljiv referenčni element lahko povzroči, da so prejšnji elementi že kopirani; napake mej in neujemanje kategorij polj cilja ne spremenijo.
Primeri
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);
}
}
}Rezultat
1 1 2 3
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.