Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

System.arraycopy — copiar um intervalo de um array

System.arraycopy copia elementos para um array existente. Suporta intervalos sobrepostos, mas exige tipos compatíveis e limites válidos.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

System.arraycopy copia length elementos de src, a partir de srcPos, para o array existente dest, a partir de destPos. Devolve void e não cria um novo array.

Os intervalos sobrepostos funcionam como se fosse utilizada memória temporária. São copiados os valores, incluindo as referências, e não os próprios objetos.

Os tipos primitivos têm de corresponder exatamente. null causa uma NullPointerException; limites inválidos ou um comprimento negativo causam uma IndexOutOfBoundsException. Argumentos que não sejam arrays ou tipos incompatíveis causam uma ArrayStoreException.

Um elemento de referência incompatível pode deixar os elementos anteriores já copiados; erros de limites e incompatibilidades de categoria de arrays não alteram o destino.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes