Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri