CKTIS / Java
Array.newInstance — dinamično ustvarjanje polj
Array.newInstance ustvarja polja na podlagi objekta Class<?>. Podpira primitivne tipe, referenčne tipe in več dimenzij.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public static Object newInstance(Class<?> componentType, int length)
public static Object newInstance(Class<?> componentType, int... dimensions)Array.newInstance iz java.lang.reflect.Array ustvari polje, kadar je njegov tip na voljo kot Class<?>. Vrne Object; pretvorba tipa se mora ujemati z dejanskim tipom polja.
Preobremenitev z int length doda eno dimenzijo. Različica int... dimensions sprejme dolžine zaporednih dimenzij. Če componentType že predstavlja polje, se nove dimenzije dodajo obstoječim; skupna omejitev je 255.
int.class ustvari polje primitivnega tipa, medtem ko Integer.class ustvari polje referenc. int[] ni Object[].
Negativna dolžina povzroči NegativeArraySizeException. Prazen seznam dimenzij, void.class ali preseganje omejitve povzroči IllegalArgumentException; vrednost null za componentType povzroči NullPointerException. Ničelne dolžine so dovoljene.
Primeri
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]);
}
}Rezultat
3:7 2x3:9
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.