java.lang.Object
java.lang.reflect.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.
- Since:
- 1.1
-
Method Summary
Modifier and TypeMethodDescriptionstatic Object
Returns the value of the indexed component in the specified array object.static boolean
getBoolean
(Object array, int index) Returns the value of the indexed component in the specified array object, as aboolean
.static byte
Returns the value of the indexed component in the specified array object, as abyte
.static char
Returns the value of the indexed component in the specified array object, as achar
.static double
Returns the value of the indexed component in the specified array object, as adouble
.static float
Returns the value of the indexed component in the specified array object, as afloat
.static int
Returns the value of the indexed component in the specified array object, as anint
.static int
Returns the length of the specified array object, as anint
.static long
Returns the value of the indexed component in the specified array object, as along
.static short
Returns the value of the indexed component in the specified array object, as ashort
.static Object
newInstance
(Class<?> componentType, int length) Creates a new array with the specified component type and length.static Object
newInstance
(Class<?> componentType, int... dimensions) Creates a new array with the specified component type and dimensions.static void
Sets the value of the indexed component of the specified array object to the specified new value.static void
setBoolean
(Object array, int index, boolean z) Sets the value of the indexed component of the specified array object to the specifiedboolean
value.static void
Sets the value of the indexed component of the specified array object to the specifiedbyte
value.static void
Sets the value of the indexed component of the specified array object to the specifiedchar
value.static void
Sets the value of the indexed component of the specified array object to the specifieddouble
value.static void
Sets the value of the indexed component of the specified array object to the specifiedfloat
value.static void
Sets the value of the indexed component of the specified array object to the specifiedint
value.static void
Sets the value of the indexed component of the specified array object to the specifiedlong
value.static void
Sets the value of the indexed component of the specified array object to the specifiedshort
value.
-
Method Details
-
newInstance
public static Object newInstance(Class<?> componentType, int length) throws NegativeArraySizeException Creates a new array with the specified component type and length.- Implementation Requirements:
- Invoking this method is equivalent to creating an array
as follows:
Array.newInstance(componentType, new int[]{length});
The number of dimensions of the new array must not exceed 255.
- Parameters:
componentType
- theClass
object representing the component type of the new arraylength
- the length of the new array- Returns:
- the new array
- Throws:
NullPointerException
- if the specifiedcomponentType
parameter is nullIllegalArgumentException
- if componentType isVoid.TYPE
or if the number of dimensions of the requested array instance exceed 255.NegativeArraySizeException
- if the specifiedlength
is negative
-
newInstance
public static Object newInstance(Class<?> componentType, int... dimensions) throws IllegalArgumentException, NegativeArraySizeException Creates a new array with the specified component type and dimensions. IfcomponentType
represents a non-array class or interface, the new array hasdimensions.length
dimensions andcomponentType
as its component type. IfcomponentType
represents an array class, the number of dimensions of the new array is equal to the sum ofdimensions.length
and the number of dimensions ofcomponentType
. In this case, the component type of the new array is the component type ofcomponentType
.The number of dimensions of the new array must not exceed 255.
- Parameters:
componentType
- theClass
object representing the component type of the new arraydimensions
- an array ofint
representing the dimensions of the new array- Returns:
- the new array
- Throws:
NullPointerException
- if the specifiedcomponentType
argument is nullIllegalArgumentException
- if the specifieddimensions
argument is a zero-dimensional array, if componentType isVoid.TYPE
, or if the number of dimensions of the requested array instance exceed 255.NegativeArraySizeException
- if any of the components in the specifieddimensions
argument is negative.
-
getLength
Returns the length of the specified array object, as anint
.- Parameters:
array
- the array- Returns:
- the length of the array
- Throws:
IllegalArgumentException
- if the object argument is not an array
-
get
public static Object get(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Returns the value of the indexed component in the specified array object. The value is automatically wrapped in an object if it has a primitive type.- Parameters:
array
- the arrayindex
- the index- Returns:
- the (possibly wrapped) value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an arrayArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array
-
getBoolean
public static boolean getBoolean(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Returns the value of the indexed component in the specified array object, as aboolean
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
getByte
public static byte getByte(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Returns the value of the indexed component in the specified array object, as abyte
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
getChar
public static char getChar(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Returns the value of the indexed component in the specified array object, as achar
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
getShort
public static short getShort(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Returns the value of the indexed component in the specified array object, as ashort
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
getInt
public static int getInt(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Returns the value of the indexed component in the specified array object, as anint
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
getLong
public static long getLong(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Returns the value of the indexed component in the specified array object, as along
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
getFloat
public static float getFloat(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Returns the value of the indexed component in the specified array object, as afloat
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
getDouble
public static double getDouble(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Returns the value of the indexed component in the specified array object, as adouble
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
set
public static void set(Object array, int index, Object value) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Sets the value of the indexed component of the specified array object to the specified new value. The new value is first automatically unwrapped if the array has a primitive component type.- Parameters:
array
- the arrayindex
- the index into the arrayvalue
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the array component type is primitive and an unwrapping conversion failsArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array
-
setBoolean
public static void setBoolean(Object array, int index, boolean z) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Sets the value of the indexed component of the specified array object to the specifiedboolean
value.- Parameters:
array
- the arrayindex
- the index into the arrayz
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
setByte
public static void setByte(Object array, int index, byte b) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Sets the value of the indexed component of the specified array object to the specifiedbyte
value.- Parameters:
array
- the arrayindex
- the index into the arrayb
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
setChar
public static void setChar(Object array, int index, char c) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Sets the value of the indexed component of the specified array object to the specifiedchar
value.- Parameters:
array
- the arrayindex
- the index into the arrayc
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
setShort
public static void setShort(Object array, int index, short s) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Sets the value of the indexed component of the specified array object to the specifiedshort
value.- Parameters:
array
- the arrayindex
- the index into the arrays
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
setInt
public static void setInt(Object array, int index, int i) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Sets the value of the indexed component of the specified array object to the specifiedint
value.- Parameters:
array
- the arrayindex
- the index into the arrayi
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
setLong
public static void setLong(Object array, int index, long l) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Sets the value of the indexed component of the specified array object to the specifiedlong
value.- Parameters:
array
- the arrayindex
- the index into the arrayl
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
setFloat
public static void setFloat(Object array, int index, float f) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Sets the value of the indexed component of the specified array object to the specifiedfloat
value.- Parameters:
array
- the arrayindex
- the index into the arrayf
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-
setDouble
public static void setDouble(Object array, int index, double d) throws IllegalArgumentException, ArrayIndexOutOfBoundsException Sets the value of the indexed component of the specified array object to the specifieddouble
value.- Parameters:
array
- the arrayindex
- the index into the arrayd
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- 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 conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
-