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如果成分类型是 Void.TYPE或者所要求的阵列实例的维数超过255。

NegativeArraySizeException -如果指定 length是负的

newInstance

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

用指定的组件类型和尺寸创建一个新的数组。如果 componentType代表非数组的类或接口，新的阵列具有 dimensions.length尺寸和 componentType其组件类型。如果 componentType表示数组类，对新的数组的维数等于 dimensions.length和尺寸 componentType数量总和。在这种情况下，新数组的组件类型是 componentType组件类型。

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

参数

componentType代表新数组的组件类型的 类对象

dimensions - int代表新数组的维数的数组

结果

新的阵列

异常

NullPointerException -如果指定 componentType参数为null

IllegalArgumentException -如果指定 dimensions参数是一零维的数组，如果是 Void.TYPE成分类型，或者如果要求尺寸的数组实例数超过255。

NegativeArraySizeException -如果在指定的 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 -如果指定对象参数为null

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

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

setBoolean

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

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

参数

array -阵列

index -索引数组

z -索引组件的新价值

异常

NullPointerException -如果指定对象参数为null

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 -如果指定对象参数为null

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 -如果指定对象参数为null

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 -如果指定对象参数为null

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 -如果指定对象参数为null

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 -如果指定对象参数为null

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 -如果指定对象参数为null

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 -如果指定对象参数为null

IllegalArgumentException -如果指定对象参数不是数组，或者如果指定值不能转换为身份或者原始的扩大转换基本数组的组件类型

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

另请参见：

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