CKTIS / Java
Array.newInstance — criar arrays dinamicamente
Array.newInstance cria arrays a partir de um objeto Class<?>. Suporta tipos primitivos, tipos de referência e várias dimensões.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
public static Object newInstance(Class<?> componentType, int length)
public static Object newInstance(Class<?> componentType, int... dimensions)Array.newInstance, de java.lang.reflect.Array, cria um array quando o seu tipo está disponível como Class<?>. Devolve Object; qualquer conversão de tipo tem de corresponder ao tipo real do array.
A sobrecarga com int length acrescenta uma dimensão. A variante int... dimensions aceita os comprimentos sucessivos das dimensões. Se componentType já representar um array, as novas dimensões são acrescentadas às existentes; o limite total é 255.
int.class cria um array de tipo primitivo, enquanto Integer.class cria um array de referências. Um int[] não é um Object[].
Um comprimento negativo provoca NegativeArraySizeException. Uma lista de dimensões vazia, void.class ou a ultrapassagem do limite provoca IllegalArgumentException; um componentType igual a null provoca NullPointerException. São permitidos comprimentos iguais a zero.
Exemplos
import java.lang.reflect.Array;
public class Main {
public static void main(String[] args) {
Class<?> componentType = int.class;
int[] values = (int[]) Array.newInstance(componentType, 3);
values[1] = 7;
System.out.println(values.length + ":" + values[1]);
int[][] grid = (int[][]) Array.newInstance(componentType, 2, 3);
grid[1][2] = 9;
System.out.println(grid.length + "x" + grid[0].length + ":" + grid[1][2]);
}
}Resultado
3:7 2x3:9
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.