Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Array.newInstance — dynamické vytváření polí

Array.newInstance vytváří pole na základě objektu Class<?>. Podporuje primitivní typy, referenční typy i více dimenzí.

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

Syntaxe

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

Array.newInstance z java.lang.reflect.Array vytváří pole, pokud je jeho typ dostupný jako Class<?>. Vrací Object; přetypování musí odpovídat skutečnému typu pole.

Přetížení s int length přidává jednu dimenzi. Varianta int... dimensions přijímá délky jednotlivých po sobě jdoucích dimenzí. Pokud componentType již představuje pole, nové dimenze se přidají k těm stávajícím; celkový limit je 255.

int.class vytváří pole primitivního typu, zatímco Integer.class vytváří pole referencí. int[] není Object[].

Záporná délka způsobí NegativeArraySizeException. Prázdný seznam dimenzí, void.class nebo překročení limitu způsobí IllegalArgumentException; hodnota null pro componentType způsobí NullPointerException. Nulové délky jsou povoleny.

Příklady

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

Výsledek

3:7
2x3:9

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje