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.