加载中...
The Wayback Machine - https://sup1a9wrlpyh5li9ro.vcoronado.top/web/20090306081920/http://developer.android.com:80/reference/java/lang/reflect/Array.html
public final class

Array

extends Object
java.lang.Object
   ↳ java.lang.reflect.Array

Class Overview

This class provides methods to dynamically create and access arrays.

Summary

Public Methods
static Object get(Object array, int index)
Return the element of the array at the specified index.
static boolean getBoolean(Object array, int index)
Return the element of the array at the specified index, converted to a boolean if possible.
static byte getByte(Object array, int index)
Return the element of the array at the specified index, converted to a byte if possible.
static char getChar(Object array, int index)
Return the element of the array at the specified index, converted to a char if possible.
static double getDouble(Object array, int index)
Return the element of the array at the specified index, converted to a double if possible.
static float getFloat(Object array, int index)
Return the element of the array at the specified index, converted to a float if possible.
static int getInt(Object array, int index)
Return the element of the array at the specified index, converted to an int if possible.
static int getLength(Object array)
Return the length of the array.
static long getLong(Object array, int index)
Return the element of the array at the specified index, converted to a long if possible.
static short getShort(Object array, int index)
Return the element of the array at the specified index, converted to a short if possible.
static Object newInstance(Class<?> componentType, int[] dimensions)
Return a new multidimensional array of the specified component type and dimensions.
static Object newInstance(Class<?> componentType, int size)
Return a new array of the specified component type and length.
static void set(Object array, int index, Object value)
Set the element of the array at the specified index to the value.
static void setBoolean(Object array, int index, boolean value)
Set the element of the array at the specified index to the boolean value.
static void setByte(Object array, int index, byte value)
Set the element of the array at the specified index to the byte value.
static void setChar(Object array, int index, char value)
Set the element of the array at the specified index to the char value.
static void setDouble(Object array, int index, double value)
Set the element of the array at the specified index to the double value.
static void setFloat(Object array, int index, float value)
Set the element of the array at the specified index to the float value.
static void setInt(Object array, int index, int value)
Set the element of the array at the specified index to the int value.
static void setLong(Object array, int index, long value)
Set the element of the array at the specified index to the long value.
static void setShort(Object array, int index, short value)
Set the element of the array at the specified index to the short value.
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

public static Object get (Object array, int index)

Return the element of the array at the specified index. This reproduces the effect of array[index] If the array component is a base type, the result is automatically wrapped.

Parameters
array the array
index the index
Returns
  • the requested element, possibly wrapped
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static boolean getBoolean (Object array, int index)

Return the element of the array at the specified index, converted to a boolean if possible. This reproduces the effect of array[index]

Parameters
array the array
index the index
Returns
  • the requested element
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the element cannot be converted to the requested type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static byte getByte (Object array, int index)

Return the element of the array at the specified index, converted to a byte if possible. This reproduces the effect of array[index]

Parameters
array the array
index the index
Returns
  • the requested element
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the element cannot be converted to the requested type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static char getChar (Object array, int index)

Return the element of the array at the specified index, converted to a char if possible. This reproduces the effect of array[index]

Parameters
array the array
index the index
Returns
  • the requested element
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the element cannot be converted to the requested type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static double getDouble (Object array, int index)

Return the element of the array at the specified index, converted to a double if possible. This reproduces the effect of array[index]

Parameters
array the array
index the index
Returns
  • the requested element
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the element cannot be converted to the requested type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static float getFloat (Object array, int index)

Return the element of the array at the specified index, converted to a float if possible. This reproduces the effect of array[index]

Parameters
array the array
index the index
Returns
  • the requested element
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the element cannot be converted to the requested type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static int getInt (Object array, int index)

Return the element of the array at the specified index, converted to an int if possible. This reproduces the effect of array[index]

Parameters
array the array
index the index
Returns
  • the requested element
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the element cannot be converted to the requested type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static int getLength (Object array)

Return the length of the array. This reproduces the effect of array.length

Parameters
array the array
Returns
  • the length
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array

public static long getLong (Object array, int index)

Return the element of the array at the specified index, converted to a long if possible. This reproduces the effect of array[index]

Parameters
array the array
index the index
Returns
  • the requested element
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the element cannot be converted to the requested type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static short getShort (Object array, int index)

Return the element of the array at the specified index, converted to a short if possible. This reproduces the effect of array[index]

Parameters
array the array
index the index
Returns
  • the requested element
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the element cannot be converted to the requested type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static Object newInstance (Class<?> componentType, int[] dimensions)

Return a new multidimensional array of the specified component type and dimensions. This reproduces the effect of new componentType[d0][d1]...[dn] for a dimensions array of { d0, d1, ... , dn }

Parameters
componentType the component type of the new array
dimensions the dimensions of the new array
Returns
  • the new array
Throws
NullPointerException if the component type is null
NegativeArraySizeException if any of the dimensions are negative
IllegalArgumentException if the array of dimensions is of size zero, or exceeds the limit of the number of dimension for an array (currently 255)

public static Object newInstance (Class<?> componentType, int size)

Return a new array of the specified component type and length. This reproduces the effect of new componentType[size]

Parameters
componentType the component type of the new array
size the length of the new array
Returns
  • the new array
Throws
NullPointerException if the component type is null
NegativeArraySizeException if the size if negative

public static void set (Object array, int index, Object value)

Set the element of the array at the specified index to the value. This reproduces the effect of array[index] = value If the array component is a base type, the value is automatically unwrapped

Parameters
array the array
index the index
value the new value
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the value cannot be converted to the array type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static void setBoolean (Object array, int index, boolean value)

Set the element of the array at the specified index to the boolean value. This reproduces the effect of array[index] = value

Parameters
array the array
index the index
value the new value
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the value cannot be converted to the array type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static void setByte (Object array, int index, byte value)

Set the element of the array at the specified index to the byte value. This reproduces the effect of array[index] = value

Parameters
array the array
index the index
value the new value
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the value cannot be converted to the array type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static void setChar (Object array, int index, char value)

Set the element of the array at the specified index to the char value. This reproduces the effect of array[index] = value

Parameters
array the array
index the index
value the new value
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the value cannot be converted to the array type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static void setDouble (Object array, int index, double value)

Set the element of the array at the specified index to the double value. This reproduces the effect of array[index] = value

Parameters
array the array
index the index
value the new value
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the value cannot be converted to the array type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static void setFloat (Object array, int index, float value)

Set the element of the array at the specified index to the float value. This reproduces the effect of array[index] = value

Parameters
array the array
index the index
value the new value
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the value cannot be converted to the array type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static void setInt (Object array, int index, int value)

Set the element of the array at the specified index to the int value. This reproduces the effect of array[index] = value

Parameters
array the array
index the index
value the new value
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the value cannot be converted to the array type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static void setLong (Object array, int index, long value)

Set the element of the array at the specified index to the long value. This reproduces the effect of array[index] = value

Parameters
array the array
index the index
value the new value
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the value cannot be converted to the array type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length

public static void setShort (Object array, int index, short value)

Set the element of the array at the specified index to the short value. This reproduces the effect of array[index] = value

Parameters
array the array
index the index
value the new value
Throws
NullPointerException if the array is null
IllegalArgumentException if the array is not an array or the value cannot be converted to the array type by a widening conversion
ArrayIndexOutOfBoundsException if the index is out of bounds -- negative or greater than or equal to the array length