compact1, compact2, compact3

java.lang.reflect

Class Array

java.lang.Object

java.lang.reflect.Array

public final class Array
extends Object

Array类提供静态方法来动态创建和访问Java数组。

Array允许在获取或设置操作期间扩大转换，但如果发生缩小转换，则抛出IllegalArgumentException 。

方法摘要

Modifier and Type	Method and Description
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(类<?> componentType, int... dimensions) 创建具有指定组件类型和尺寸的新数组。
static Object	newInstance(类<?> componentType, int length) 创建具有指定组件类型和长度的新数组。
static void	set(Object array, int index, Object value) 将指定数组对象的索引组件的值设置为指定的新值。
static void	setBoolean(Object array, int index, boolean z) 将指定数组对象的索引组件的值设置为指定的 boolean值。
static void	setByte(Object array, int index, byte b) 将指定数组对象的索引组件的值设置为指定的 byte值。
static void	setChar(Object array, int index, char c) 将指定数组对象的索引组件的值设置为指定的 char值。
static void	setDouble(Object array, int index, double d) 将指定数组对象的索引组件的值设置为指定的 double值。
static void	setFloat(Object array, int index, float f) 将指定数组对象的索引组件的值设置为指定的 float值。
static void	setInt(Object array, int index, int i) 将指定数组对象的索引组件的值设置为指定的 int值。
static void	setLong(Object array, int index, long l) 将指定数组对象的索引组件的值设置为指定的 long值。
static void	setShort(Object array, int index, short s) 将指定数组对象的索引组件的值设置为指定的 short值。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细信息

newInstance

public static Object newInstance(类<?> componentType,
                                 int length)
                          throws NegativeArraySizeException

创建具有指定组件类型和长度的新数组。 调用此方法相当于创建一个数组，如下所示：

 int[] x = {length};
 Array.newInstance(componentType, x);
 

新数组的维数不能超过255。

参数

componentType - 表示新数组的组件类型的 类对象

length - 新数组的长度

结果

新数组

异常

NullPointerException - 如果指定的 componentType参数为空

IllegalArgumentException - 如果componentType为 Void.TYPE，或者请求的数组实例的维数超过255。

NegativeArraySizeException - 如果指定的 length为负数

newInstance

public static Object newInstance(类<?> componentType,
                                 int... dimensions)
                          throws IllegalArgumentException,
                                 NegativeArraySizeException

创建具有指定组件类型和尺寸的新数组。 如果componentType表示非数组类或接口，则新数组具有dimensions.length尺寸和componentType作为其组件类型。 如果componentType表示数组类，则新数组的维数等于dimensions.length和dimensions.length数componentType之componentType 。 在这种情况下，新阵列的组件类型为componentType的组件类型。

新数组的维数不能超过255。

参数

componentType - 表示新数组的组件类型的 类对象

dimensions - 表示新数组的 int的数组 int

结果

新数组

异常

NullPointerException - 如果指定的 componentType参数为空

IllegalArgumentException - 如果指定的 dimensions参数是零维数组，如果componentType为 Void.TYPE ，或者所请求的数组实例的维数超过255。

NegativeArraySizeException - 如果指定的 dimensions参数中的任何 dimensions为负。

getLength

public static int getLength(Object array)
                     throws IllegalArgumentException

返回指定数组对象的长度，如 int 。

参数

array - 数组

结果

数组的长度

异常

IllegalArgumentException - 如果对象参数不是数组

get

public static Object get(Object array,
                         int index)
                  throws IllegalArgumentException,
                         ArrayIndexOutOfBoundsException

返回指定数组对象中的索引组件的值。 如果该对象具有原始类型，则该值将自动包装在对象中。

参数

array - 数组

index - 索引

结果

指定数组中的索引组件的（可能包装的）值

异常

NullPointerException - 如果指定的对象为空

IllegalArgumentException - 如果指定的对象不是数组

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

getBoolean

public static boolean getBoolean(Object array,
                                 int index)
                          throws IllegalArgumentException,
                                 ArrayIndexOutOfBoundsException

返回指定数组对象中的索引组件的值，如 boolean 。

参数

array - 数组

index - 索引

结果

指定数组中的索引组件的值

异常

NullPointerException - 如果指定的对象为空

IllegalArgumentException - 如果指定的对象不是数组，或者索引元素不能通过标识或扩展转换转换为返回类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

get(java.lang.Object, int)

getByte

public static byte getByte(Object array,
                           int index)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

返回指定数组对象中的索引组件的值，如 byte 。

参数

array - 数组

index - 索引

结果

指定数组中的索引组件的值

异常

NullPointerException - 如果指定的对象为空

IllegalArgumentException - 如果指定的对象不是数组，或者索引元素不能通过标识或扩展转换转换为返回类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

get(java.lang.Object, int)

getChar

public static char getChar(Object array,
                           int index)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

返回指定数组对象中索引组件的值，如 char 。

参数

array - 数组

index - 索引

结果

指定数组中的索引组件的值

异常

NullPointerException - 如果指定的对象为空

IllegalArgumentException - 如果指定的对象不是数组，或者索引元素不能通过标识或扩展转换转换为返回类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

get(java.lang.Object, int)

getShort

public static short getShort(Object array,
                             int index)
                      throws IllegalArgumentException,
                             ArrayIndexOutOfBoundsException

返回指定数组对象中的索引组件的值，如 short 。

参数

array - 数组

index - 索引

结果

指定数组中的索引组件的值

异常

NullPointerException - 如果指定的对象为空

IllegalArgumentException - 如果指定的对象不是数组，或者索引元素不能通过标识或扩展转换转换为返回类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

get(java.lang.Object, int)

getInt

public static int getInt(Object array,
                         int index)
                  throws IllegalArgumentException,
                         ArrayIndexOutOfBoundsException

返回指定数组对象中的索引组件的值，如 int 。

参数

array - 数组

index - 索引

结果

指定数组中的索引组件的值

异常

NullPointerException - 如果指定的对象为空

IllegalArgumentException - 如果指定的对象不是数组，或者索引元素不能通过标识或扩展转换转换为返回类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

get(java.lang.Object, int)

getLong

public static long getLong(Object array,
                           int index)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

返回指定数组对象中的索引组件的值，如 long 。

参数

array - 数组

index - 索引

结果

指定数组中的索引组件的值

异常

NullPointerException - 如果指定的对象为空

IllegalArgumentException - 如果指定的对象不是数组，或者索引元素不能通过标识或扩展转换转换为返回类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

get(java.lang.Object, int)

getFloat

public static float getFloat(Object array,
                             int index)
                      throws IllegalArgumentException,
                             ArrayIndexOutOfBoundsException

返回指定数组对象中索引组件的值，如 float 。

参数

array - 数组

index - 索引

结果

指定数组中的索引组件的值

异常

NullPointerException - 如果指定的对象为空

IllegalArgumentException - 如果指定的对象不是数组，或者索引的元素不能通过标识或扩展转换转换为返回类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果它大于或等于指定数组的长度

另请参见：

get(java.lang.Object, int)

getDouble

public static double getDouble(Object array,
                               int index)
                        throws IllegalArgumentException,
                               ArrayIndexOutOfBoundsException

返回指定数组对象中的索引组件的值，如 double 。

参数

array - 阵列

index - 索引

结果

指定数组中的索引组件的值

异常

NullPointerException - 如果指定的对象为空

IllegalArgumentException - 如果指定的对象不是数组，或者索引元素不能通过标识或扩展转换转换为返回类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

get(java.lang.Object, int)

set

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

将指定数组对象的索引组件的值设置为指定的新值。 如果数组具有原始组件类型，则新值将首先被自动解包。

参数

array - 数组

index - 数组中的索引

value - 索引组件的新值

异常

NullPointerException - 如果指定的对象参数为空

IllegalArgumentException - 如果指定的对象参数不是数组，或者数组组件类型是原始的，并且解包转换失败

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负数，或者如果大于或等于指定数组的长度

setBoolean

public static void setBoolean(Object array,
                              int index,
                              boolean z)
                       throws IllegalArgumentException,
                              ArrayIndexOutOfBoundsException

将指定数组对象的索引组件的值设置为指定的 boolean值。

参数

array - 数组

index - 数组中的索引

z - 索引组件的新值

异常

NullPointerException - 如果指定的对象参数为空

IllegalArgumentException - 如果指定的对象参数不是数组，或者指定的值不能通过标识或原始加宽转换转换为底层数组的组件类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

set(java.lang.Object, int, java.lang.Object)

setByte

public static void setByte(Object array,
                           int index,
                           byte b)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

将指定数组对象的索引组件的值设置为指定的 byte值。

参数

array - 数组

index - 数组中的索引

b - 索引组件的新值

异常

NullPointerException - 如果指定的对象参数为空

IllegalArgumentException - 如果指定的对象参数不是数组，或者指定的值不能通过标识或原始加宽转换转换为底层数组的组件类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

set(java.lang.Object, int, java.lang.Object)

setChar

public static void setChar(Object array,
                           int index,
                           char c)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

将指定数组对象的索引组件的值设置为指定的 char值。

参数

array - 数组

index - 数组中的索引

c - 索引组件的新值

异常

NullPointerException - 如果指定的对象参数为空

IllegalArgumentException - 如果指定的对象参数不是数组，或者指定的值不能通过标识或原始加宽转换转换为底层数组的组件类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

set(java.lang.Object, int, java.lang.Object)

setShort

public static void setShort(Object array,
                            int index,
                            short s)
                     throws IllegalArgumentException,
                            ArrayIndexOutOfBoundsException

将指定数组对象的索引组件的值设置为指定的 short值。

参数

array - 数组

index - 数组中的索引

s - 索引组件的新值

异常

NullPointerException - 如果指定的对象参数为空

IllegalArgumentException - 如果指定的对象参数不是数组，或者指定的值不能通过标识或原始加宽转换转换为底层数组的组件类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

set(java.lang.Object, int, java.lang.Object)

setInt

public static void setInt(Object array,
                          int index,
                          int i)
                   throws IllegalArgumentException,
                          ArrayIndexOutOfBoundsException

将指定数组对象的索引组件的值设置为指定的 int值。

参数

array - 数组

index - 数组中的索引

i - 索引组件的新值

异常

NullPointerException - 如果指定的对象参数为空

IllegalArgumentException - 如果指定的对象参数不是数组，或者指定的值不能通过标识或基本扩展转换转换为底层数组的组件类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

set(java.lang.Object, int, java.lang.Object)

setLong

public static void setLong(Object array,
                           int index,
                           long l)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

将指定数组对象的索引组件的值设置为指定的 long值。

参数

array - 数组

index - 数组中的索引

l - 索引组件的新值

异常

NullPointerException - 如果指定的对象参数为空

IllegalArgumentException - 如果指定的对象参数不是数组，或者指定的值不能通过标识或原始加宽转换转换为底层数组的组件类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果它大于或等于指定数组的长度

另请参见：

set(java.lang.Object, int, java.lang.Object)

setFloat

public static void setFloat(Object array,
                            int index,
                            float f)
                     throws IllegalArgumentException,
                            ArrayIndexOutOfBoundsException

将指定数组对象的索引组件的值设置为指定的 float值。

参数

array - 数组

index - 数组中的索引

f - 索引组件的新值

异常

NullPointerException - 如果指定的对象参数为空

IllegalArgumentException - 如果指定的对象参数不是数组，或者指定的值不能通过标识或原始的扩展转换转换为底层数组的组件类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果大于或等于指定数组的长度

另请参见：

set(java.lang.Object, int, java.lang.Object)

setDouble

public static void setDouble(Object array,
                             int index,
                             double d)
                      throws IllegalArgumentException,
                             ArrayIndexOutOfBoundsException

将指定数组对象的索引组件的值设置为指定的 double值。

参数

array - 数组

index - 数组中的索引

d - 索引组件的新值

异常

NullPointerException - 如果指定的对象参数为空

IllegalArgumentException - 如果指定的对象参数不是数组，或者指定的值不能通过标识或原始加宽转换转换为基础数组的组件类型

ArrayIndexOutOfBoundsException - 如果指定的 index参数为负，或者如果它大于或等于指定数组的长度

另请参见：

set(java.lang.Object, int, java.lang.Object)