Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

System.arraycopy — kopiowanie fragmentu tablicy

System.arraycopy kopiuje elementy do istniejącej tablicy; obsługuje nakładanie zakresów, ale wymaga zgodnych typów i poprawnych granic.

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

Składnia

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

System.arraycopy kopiuje length elementów z src, od indeksu srcPos, do istniejącej tablicy dest, od destPos. Zwraca void; nie tworzy tablicy wynikowej.

Nakładanie zakresów jest bezpieczne, jak przy użyciu bufora tymczasowego. Kopiowane są wartości, w tym referencje — nie same obiekty.

Typy prymitywne muszą być identyczne. null powoduje NullPointerException; błędne granice lub ujemna długość — IndexOutOfBoundsException. Argument niebędący tablicą lub niezgodność typów powoduje ArrayStoreException.

Przy niezgodnym elemencie referencyjnym wcześniejsze elementy mogą już zostać skopiowane; błędy granic i niezgodność kategorii tablic nie zmieniają celu.

Przykłady

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);
        }
    }
}

Wynik

1
1
2
3

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła