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

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.

Fontes