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.