java.lang.Object java.lang.reflect.Array
public final class Array
The Array class provides static methods to dynamically create and access Java arrays.
Array permits widening conversions to occur during a get or set operation, but throws an IllegalArgumentException if a narrowing conversion would occur.
static Object get(Object array, int index)
static boolean getBoolean(Object array, int index)
boolean. static byte getByte(Object array, int index)
byte. static char getChar(Object array, int index)
char. static double getDouble(Object array, int index)
double. static float getFloat(Object array, int index)
float. static int getInt(Object array, int index)
int. static int getLength(Object array)
int. static long getLong(Object array, int index)
long. static short getShort(Object array, int index)
short. static Object newInstance(Class<?> componentType, int length)
static Object newInstance(Class<?> componentType, int[] dimensions)
static void set(Object array, int index, Object value)
static void setBoolean(Object array, int index, boolean z)
boolean value. static void setByte(Object array, int index, byte b)
byte value. static void setChar(Object array, int index, char c)
char value. static void setDouble(Object array, int index, double d)
double value. static void setFloat(Object array, int index, float f)
float value. static void setInt(Object array, int index, int i)
int value. static void setLong(Object array, int index, long l)
long value. static void setShort(Object array, int index, short s)
short value. Methods inherited from class java.lang.Object clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait newInstance
public static Object newInstance(Class<?> componentType,
int length)
throws NegativeArraySizeException
int[] x = {length};
Array.newInstance(componentType, x);
componentType - the Class object representing the component type of the new array
length - the length of the new array
NullPointerException - if the specified componentType parameter is null
IllegalArgumentException - if componentType is Void.TYPE
NegativeArraySizeException - if the specified length is negative
public static Object newInstance(Class<?> componentType,
int[] dimensions)
throws IllegalArgumentException,
NegativeArraySizeException
componentType represents a non-array class or interface, the new array has dimensions.length dimensions and componentType as its component type. If componentType represents an array class, the number of dimensions of the new array is equal to the sum of dimensions.length and the number of dimensions of componentType. In this case, the component type of the new array is the component type of componentType.
The number of dimensions of the new array must not exceed the number of array dimensions supported by the implementation (typically 255).
componentType - the Class object representing the component type of the new array
dimensions - an array of int types representing the dimensions of the new array
NullPointerException - if the specified componentType argument is null
IllegalArgumentException - if the specified dimensions argument is a zero-dimensional array, or if the number of requested dimensions exceeds the limit on the number of array dimensions supported by the implementation (typically 255), or if componentType is Void.TYPE.
NegativeArraySizeException - if any of the components in the specified dimensions argument is negative.
public static int getLength(Object array)
throws IllegalArgumentException
int.
array - the array
IllegalArgumentException - if the object argument is not an array
public static Object get(Object array,
int index)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
array - the array
index - the index
NullPointerException - If the specified object is null
IllegalArgumentException - If the specified object is not an array
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
public static boolean getBoolean(Object array,
int index)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
boolean.
array - the array
index - the index
NullPointerException - If the specified object is null
IllegalArgumentException - If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
get(java.lang.Object, int)
public static byte getByte(Object array,
int index)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
byte.
array - the array
index - the index
NullPointerException - If the specified object is null
IllegalArgumentException - If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
get(java.lang.Object, int)
public static char getChar(Object array,
int index)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
char.
array - the array
index - the index
NullPointerException - If the specified object is null
IllegalArgumentException - If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
get(java.lang.Object, int)
public static short getShort(Object array,
int index)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
short.
array - the array
index - the index
NullPointerException - If the specified object is null
IllegalArgumentException - If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
get(java.lang.Object, int)
public static int getInt(Object array,
int index)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
int.
array - the array
index - the index
NullPointerException - If the specified object is null
IllegalArgumentException - If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
get(java.lang.Object, int)
public static long getLong(Object array,
int index)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
long.
array - the array
index - the index
NullPointerException - If the specified object is null
IllegalArgumentException - If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
get(java.lang.Object, int)
public static float getFloat(Object array,
int index)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
float.
array - the array
index - the index
NullPointerException - If the specified object is null
IllegalArgumentException - If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
get(java.lang.Object, int)
public static double getDouble(Object array,
int index)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
double.
array - the array
index - the index
NullPointerException - If the specified object is null
IllegalArgumentException - If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
get(java.lang.Object, int)
public static void set(Object array,
int index,
Object value)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
array - the array
index - the index into the array
value - the new value of the indexed component
NullPointerException - If the specified object argument is null
IllegalArgumentException - If the specified object argument is not an array, or if the array component type is primitive and an unwrapping conversion fails
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
public static void setBoolean(Object array,
int index,
boolean z)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
boolean value.
array - the array
index - the index into the array
z - the new value of the indexed component
NullPointerException - If the specified object argument is null
IllegalArgumentException - If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
set(java.lang.Object, int, java.lang.Object)
public static void setByte(Object array,
int index,
byte b)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
byte value.
array - the array
index - the index into the array
b - the new value of the indexed component
NullPointerException - If the specified object argument is null
IllegalArgumentException - If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
set(java.lang.Object, int, java.lang.Object)
public static void setChar(Object array,
int index,
char c)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
char value.
array - the array
index - the index into the array
c - the new value of the indexed component
NullPointerException - If the specified object argument is null
IllegalArgumentException - If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
set(java.lang.Object, int, java.lang.Object)
public static void setShort(Object array,
int index,
short s)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
short value.
array - the array
index - the index into the array
s - the new value of the indexed component
NullPointerException - If the specified object argument is null
IllegalArgumentException - If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
set(java.lang.Object, int, java.lang.Object)
public static void setInt(Object array,
int index,
int i)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
int value.
array - the array
index - the index into the array
i - the new value of the indexed component
NullPointerException - If the specified object argument is null
IllegalArgumentException - If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
set(java.lang.Object, int, java.lang.Object)
public static void setLong(Object array,
int index,
long l)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
long value.
array - the array
index - the index into the array
l - the new value of the indexed component
NullPointerException - If the specified object argument is null
IllegalArgumentException - If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
set(java.lang.Object, int, java.lang.Object)
public static void setFloat(Object array,
int index,
float f)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
float value.
array - the array
index - the index into the array
f - the new value of the indexed component
NullPointerException - If the specified object argument is null
IllegalArgumentException - If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
set(java.lang.Object, int, java.lang.Object)
public static void setDouble(Object array,
int index,
double d)
throws IllegalArgumentException,
ArrayIndexOutOfBoundsException
double value.
array - the array
index - the index into the array
d - the new value of the indexed component
NullPointerException - If the specified object argument is null
IllegalArgumentException - If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversion
ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
set(java.lang.Object, int, java.lang.Object)
Copyright © 2004, 2010 Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4