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

CKTIS / Java

array.clone() — uma cópia superficial de um array

array.clone() cria um novo array com cópias dos valores dos seus elementos. Os valores primitivos são independentes, mas as referências continuam a apontar para os mesmos objetos; nos arrays multidimensionais, os subarrays são partilhados.

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

Sintaxe

array.clone()

array.clone() cria um novo array com o mesmo comprimento e copia os valores dos seus elementos. Ao contrário da atribuição copy = array, o resultado é um objeto array separado.

Para uma expressão do tipo T[], o resultado tem o tipo T[], mesmo quando T é um tipo primitivo; não é necessário fazer uma conversão. O método clone() dos arrays é public e não lança exceções verificadas, pelo que não é necessário tratar CloneNotSupportedException.

Trata-se de uma cópia superficial, não de uma cópia profunda. Em int[], alterar um elemento da cópia não altera o original. Nos arrays de objetos, são copiadas as referências, não os objetos. Em int[][], só o array exterior é novo: os subarrays continuam a ser partilhados. Substituir um elemento do array exterior e modificar um subarray partilhado são operações diferentes.

Exemplos

public class Main {
    public static void main(String[] args) {
        int[] numbers = {1, 2};
        int[] copy = numbers.clone();
        copy[0] = 9;
        System.out.println(numbers == copy);
        System.out.println(numbers[0] + " " + copy[0]);

        int[][] rows = {{3, 4}};
        int[][] rowsCopy = rows.clone();
        System.out.println(rows == rowsCopy);
        System.out.println(rows[0] == rowsCopy[0]);
        rowsCopy[0][0] = 8;
        System.out.println(rows[0][0]);
    }
}

Resultado

false
1 9
false
true
8

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