WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Array.newInstance — Arrays dynamisch erstellen

Array.newInstance erstellt Arrays anhand eines Class<?>-Objekts. Die Methode unterstützt primitive Typen, Referenztypen und mehrere Dimensionen.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

public static Object newInstance(Class<?> componentType, int length)
public static Object newInstance(Class<?> componentType, int... dimensions)

Array.newInstance aus java.lang.reflect.Array erstellt ein Array, wenn dessen Typ als Class<?> verfügbar ist. Die Methode gibt Object zurück; eine Typumwandlung muss dem tatsächlichen Arraytyp entsprechen.

Die Überladung mit int length fügt eine Dimension hinzu. Die Variante int... dimensions nimmt die Längen aufeinanderfolgender Dimensionen entgegen. Wenn componentType bereits ein Array darstellt, werden die neuen Dimensionen zu den vorhandenen hinzugefügt; insgesamt sind höchstens 255 Dimensionen zulässig.

int.class erstellt ein Array eines primitiven Typs, während Integer.class ein Referenzarray erstellt. Ein int[] ist kein Object[].

Eine negative Länge führt zu NegativeArraySizeException. Eine leere Dimensionsliste, void.class oder das Überschreiten des Limits führt zu IllegalArgumentException; ein null-Wert für componentType führt zu NullPointerException. Längen von null sind zulässig.

Beispiele

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]);
    }
}

Ergebnis

3:7
2x3:9

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen