| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public final class Array extends Object
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.
Method Summary | |
---|---|
static native Object |
Returns the value of the indexed component in the specified array object. |
static native boolean |
getBoolean(Object array, int index) Returns the value of the indexed component in the specified array object, as a boolean .
|
static native byte |
Returns the value of the indexed component in the specified array object, as a byte .
|
static native char |
Returns the value of the indexed component in the specified array object, as a char .
|
static native double |
Returns the value of the indexed component in the specified array object, as a double .
|
static native float |
Returns the value of the indexed component in the specified array object, as a float .
|
static native int |
Returns the value of the indexed component in the specified array object, as an int .
|
static native int |
Returns the length of the specified array object, as an int .
|
static native long |
Returns the value of the indexed component in the specified array object, as a long .
|
static native short |
Returns the value of the indexed component in the specified array object, as a short .
|
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 native void |
Sets the value of the indexed component of the specified array object to the specified new value. |
static native void |
setBoolean(Object array, int index, boolean z) Sets the value of the indexed component of the specified array object to the specified boolean value.
|
static native void |
Sets the value of the indexed component of the specified array object to the specified byte value.
|
static native void |
Sets the value of the indexed component of the specified array object to the specified char value.
|
static native void |
Sets the value of the indexed component of the specified array object to the specified double value.
|
static native void |
Sets the value of the indexed component of the specified array object to the specified float value.
|
static native void |
Sets the value of the indexed component of the specified array object to the specified int value.
|
static native void |
Sets the value of the indexed component of the specified array object to the specified long value.
|
static native void |
Sets the value of the indexed component of the specified array object to the specified short value.
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static native Object get(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
array
- the arrayindex
- the indexIllegalArgumentException
- If the specified object is not
an arrayArrayIndexOutOfBoundsException
- If the specified index
argument is negative, or if it is greater than or equal to the
length of the specified arraypublic static native boolean getBoolean(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
boolean
.
array
- the arrayindex
- the indexIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to the
length of the specified arraypublic static native byte getByte(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
byte
.
array
- the arrayindex
- the indexIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to the
length of the specified arraypublic static native char getChar(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
char
.
array
- the arrayindex
- the indexIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to the
length of the specified arraypublic static native double getDouble(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
double
.
array
- the arrayindex
- the indexIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to the
length of the specified arraypublic static native float getFloat(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
float
.
array
- the arrayindex
- the indexIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to the
length of the specified arraypublic static native int getInt(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
int
.
array
- the arrayindex
- the indexIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to the
length of the specified arraypublic static native int getLength(Object array) throws IllegalArgumentException
int
.
array
- the arrayIllegalArgumentException
- if the object argument is not
an arraypublic static native long getLong(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
long
.
array
- the arrayindex
- the indexIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to the
length of the specified arraypublic static native short getShort(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
short
.
array
- the arrayindex
- the indexIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to the
length of the specified arraypublic 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 arraylength
- the length of the new arrayNegativeArraySizeException
- if the specified length
is negativepublic 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 arraydimensions
- an array of int
representing the dimensions of
the new arrayIllegalArgumentException
- 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 {@link Void#TYPE}.NegativeArraySizeException
- if any of the components in
the specified dimensions
argument is negative.public static native void set(Object array, int index, Object value) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
array
- the arrayindex
- the index into the arrayvalue
- the new value of the indexed componentIllegalArgumentException
- If the specified object argument
is not an array, or if the array component type is primitive and
an unwrapping conversion failsArrayIndexOutOfBoundsException
- If the specified index
argument is negative, or if it is greater than or equal to
the length of the specified arraypublic static native void setBoolean(Object array, int index, boolean z) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
boolean
value.
array
- the arrayindex
- the index into the arrayz
- the new value of the indexed componentIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to
the length of the specified arraypublic static native void setByte(Object array, int index, byte b) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
byte
value.
array
- the arrayindex
- the index into the arrayb
- the new value of the indexed componentIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to
the length of the specified arraypublic static native void setChar(Object array, int index, char c) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
char
value.
array
- the arrayindex
- the index into the arrayc
- the new value of the indexed componentIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to
the length of the specified arraypublic static native void setDouble(Object array, int index, double d) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
double
value.
array
- the arrayindex
- the index into the arrayd
- the new value of the indexed componentIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to
the length of the specified arraypublic static native void setFloat(Object array, int index, float f) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
float
value.
array
- the arrayindex
- the index into the arrayf
- the new value of the indexed componentIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to
the length of the specified arraypublic static native void setInt(Object array, int index, int i) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
int
value.
array
- the arrayindex
- the index into the arrayi
- the new value of the indexed componentIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to
the length of the specified arraypublic static native void setLong(Object array, int index, long l) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
long
value.
array
- the arrayindex
- the index into the arrayl
- the new value of the indexed componentIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to
the length of the specified arraypublic static native void setShort(Object array, int index, short s) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
short
value.
array
- the arrayindex
- the index into the arrays
- the new value of the indexed componentIllegalArgumentException
- 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 specified index
argument is negative, or if it is greater than or equal to
the length of the specified array
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |