CKTIS / Java
Array.newInstance — arrays dynamisch aanmaken
Array.newInstance maakt arrays aan op basis van een Class<?>-object. De methode ondersteunt primitieve typen, referentietypen en meerdere dimensies.
Versie: 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 uit java.lang.reflect.Array maakt een array aan wanneer het type beschikbaar is als Class<?>. De methode retourneert Object; een cast moet overeenkomen met het werkelijke arraytype.
De overload met int length voegt één dimensie toe. De variant int... dimensions accepteert de lengtes van opeenvolgende dimensies. Als componentType al een array voorstelt, worden de nieuwe dimensies aan de bestaande toegevoegd; het totale maximum is 255.
int.class maakt een array van een primitief type, terwijl Integer.class een referentie-array maakt. Een int[] is geen Object[].
Een negatieve lengte veroorzaakt NegativeArraySizeException. Een lege lijst met dimensies, void.class of het overschrijden van de limiet veroorzaakt IllegalArgumentException; een componentType met de waarde null veroorzaakt NullPointerException. Lengtes van nul zijn toegestaan.
Voorbeelden
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]);
}
}Resultaat
3:7 2x3:9
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.