This class contains methods that allow
you to set and query the values of array elements, to determine the
length of an array, and to create new instances of arrays. Note that
the Array class can manipulate only array values,
not array types; Java data types, including array types, are
represented by java.lang.Class. Since the
Array class represents a Java value, unlike the
Field, Method, and
Constructor classes, which represent class
members, the Array class is significantly
different (despite some surface similarities) from those other
classes in this package. Most notably, all the methods of
Array are static and apply to all array values,
not just a specific field, method, or constructor.
The get( ) method
returns the value of the specified element of the specified array as
an Object. If the array elements are of a
primitive type, the value is converted to a wrapper object before
being returned. You can also use getInt( ) and
related methods to query array elements and return them as specific
primitive types. The set( ) method and its
primitive type variants perform the opposite operation. Also, the
getLength( ) method returns the length of the
array.
The newInstance( )
methods create new arrays. One version of this method is passed the
number of elements in the array and the type of those elements. The
other version of this method creates multidimensional arrays. Besides
specifying the component type of the array, it is passed an array of
numbers. The length of this array specifies the number of dimensions
for the array to be created, and the values of each of the array
elements specify the size of each dimension of the created array.
public final class
Array {
// No Constructor
// Public Class Methods
public static Object
get (Object
array , int
index )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static boolean
getBoolean (Object
array , int
index )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static byte
getByte (Object
array , int
index )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static char
getChar (Object
array , int
index )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static double
getDouble (Object
array , int
index )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static float
getFloat (Object
array , int
index )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static int
getInt (Object
array , int
index )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static int
getLength (Object
array )
throws IllegalArgumentException; native
public static long
getLong (Object
array , int
index )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static short
getShort (Object
array , int
index )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static Object
newInstance (Class<?>
componentType , int
length )
throws NegativeArraySizeException;
public static Object
newInstance (Class<?>
componentType , int[ ]
dimensions )
throws IllegalArgumentException, NegativeArraySizeException;
public static void
set (Object
array , int
index , Object
value )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static void
setBoolean (Object
array , int
index , boolean
z )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static void
setByte (Object
array , int
index , byte
b )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static void
setChar (Object
array , int
index , char
c )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static void
setDouble (Object
array , int
index , double
d )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static void
setFloat (Object
array , int
index , float
f )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static void
setInt (Object
array , int
index , int
i )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static void
setLong (Object
array , int
index , long
l )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
public static void
setShort (Object
array , int
index , short
s )
throws IllegalArgumentException, ArrayIndexOutOfBoundsException; native
}