Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

System.arraycopy — copiar un rango de un array

System.arraycopy copia elementos en un array existente. Admite rangos solapados, pero requiere tipos compatibles y límites válidos.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

System.arraycopy copia length elementos de src, desde srcPos, al array existente dest, desde destPos. Devuelve void; no crea un array nuevo.

Los rangos solapados funcionan como si se utilizara almacenamiento temporal. Se copian los valores, incluidas las referencias, no los objetos en sí.

Los tipos primitivos deben coincidir exactamente. null provoca NullPointerException; los límites no válidos o una longitud negativa provocan IndexOutOfBoundsException. Los argumentos que no sean arrays o los tipos incompatibles provocan ArrayStoreException.

Un elemento de referencia incompatible puede hacer que los elementos anteriores ya se hayan copiado; los errores de límites y las incompatibilidades de categoría de arrays dejan el destino sin cambios.

Ejemplos

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

Resultado

1
1
2
3

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes