概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

java.lang.reflect
類別 Array

java.lang.Object
  繼承者 java.lang.reflect.Array

public final class Array
extends Object

Array 類別提供了動態創建和存取 Java 陣列的方法。

Array 允許在執行 get 或 set 操作期間進行擴展轉換，但如果發生收縮轉換，則拋出 IllegalArgumentException。

方法摘要
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(Class<?> componentType, int... dimensions)
          創建一個具有指定的元件型別和維度的新陣列。
static Object newInstance(Class<?> 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 值。
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

方法詳細資訊

newInstance

public static Object newInstance(Class<?> componentType,
                                 int length)
                          throws NegativeArraySizeException
創建一個具有指定的元件型別和長度的新陣列。調用此方法等效於創建如下陣列： 
 int[] x = {length};
 Array.newInstance(componentType, x);

參數：
componentType - 表示新陣列的元件型別的 Class 物件
length - 新陣列的長度
返回：
新陣列
拋出：
NullPointerException - 如果指定的 componentType 參數為 null
IllegalArgumentException - 如果 componentType 為 Void.TYPE
NegativeArraySizeException - 如果指定的 length 為負

newInstance

public static Object newInstance(Class<?> componentType,
                                 int... dimensions)
                          throws IllegalArgumentException,
                                 NegativeArraySizeException
創建一個具有指定的元件型別和維度的新陣列。如果 componentType 表示一個非陣列類別或介面，則新陣列具有 dimensions.length 維度，並且將 componentType 作為其元件型別。如果 componentType 表示一個陣列類別，則新陣列的維數等於 dimensions.length 和 componentType 的維數的總和。在這種情況下，新陣列的元件型別為 componentType 的元件型別。

新陣列的維數不能超過該實作所支持的陣列維數（通常為 255）。

參數：
componentType - 表示新陣列的元件型別的 Class 物件
dimensions - 表示新陣列維度的 int 陣列
返回：
新陣列
拋出：
NullPointerException - 如果指定的 componentType 參數為 null
IllegalArgumentException - 如果指定的 dimensions 參數是一個零維度的陣列，或者所請求的維數超過了該實作所支持的陣列維數的限制（通常為 225），或者度的陣列，或者所請求的維數超過了該實作所支持的陣列維數的限制（通常為 225），或者 componentType 為 Void.TYPE。
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 - 如果指定物件為 null
IllegalArgumentException - 如果指定物件不是一個陣列
ArrayIndexOutOfBoundsException - 如果指定的 index 參數為負，或者它大於等於指定陣列的長度

getBoolean

public static boolean getBoolean(Object array,
                                 int index)
                          throws IllegalArgumentException,
                                 ArrayIndexOutOfBoundsException
以 boolean 形式返回指定陣列物件中索引元件的值。

參數：
array - 陣列
index - 索引
返回：
指定陣列中索引元件的值
拋出：
NullPointerException - 如果指定物件為 null
IllegalArgumentException - 如果指定物件不是一個陣列，或者無法通過一個恆等或擴展轉換將索引元素轉換為返回型別
ArrayIndexOutOfBoundsException - 如果指定的 index 參數為負，或者它大於等於指定陣列的長度
另請參見：
get(java.lang.Object, int)

getByte

public static byte getByte(Object array,
                           int index)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException
以 byte 形式返回指定陣列物件中索引元件的值。

參數：
array - 陣列
index - 索引
返回：
指定陣列中索引元件的值
拋出：
NullPointerException - 如果指定物件為 null
IllegalArgumentException - 如果指定物件不是一個陣列，或者無法通過一個恆等或擴展轉換將索引元素轉換為返回型別
ArrayIndexOutOfBoundsException - 如果指定的 index 參數為負，或者它大於等於指定陣列的長度
另請參見：
get(java.lang.Object, int)

getChar

public static char getChar(Object array,
                           int index)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException
以 char 形式返回指定陣列物件中索引元件的值。

參數：
array - 陣列
index - 索引
返回：
指定陣列中索引元件的值
拋出：
NullPointerException - 如果指定物件為 null
IllegalArgumentException - 如果指定物件不是一個陣列，或者無法通過一個恆等或擴展轉換將索引元素轉換為返回型別
ArrayIndexOutOfBoundsException - 如果指定的 index 參數為負，或者它大於等於指定陣列的長度
另請參見：
get(java.lang.Object, int)

getShort

public static short getShort(Object array,
                             int index)
                      throws IllegalArgumentException,
                             ArrayIndexOutOfBoundsException
以 short 形式返回指定陣列物件中索引元件的值。

參數：
array - 陣列
index - 索引
返回：
指定陣列中索引元件的值
拋出：
NullPointerException - 如果指定物件為 null
IllegalArgumentException - 如果指定物件不是一個陣列，或者無法通過一個恆等或擴展轉換將索引元素轉換為返回型別
ArrayIndexOutOfBoundsException - 如果指定的 index 參數為負，或者它大於等於指定陣列的長度
另請參見：
get(java.lang.Object, int)

getInt

public static int getInt(Object array,
                         int index)
                  throws IllegalArgumentException,
                         ArrayIndexOutOfBoundsException
以 int 形式返回指定陣列物件中索引元件的值。

參數：
array - 陣列
index - 索引
返回：
指定陣列中索引元件的值
拋出：
NullPointerException - 如果指定物件為 null
IllegalArgumentException - 如果指定物件不是一個陣列，或者無法通過一個恆等或擴展轉換將索引元素轉換為返回型別
ArrayIndexOutOfBoundsException - 如果指定的 index 參數為負，或者它大於等於指定陣列的長度
另請參見：
get(java.lang.Object, int)

getLong

public static long getLong(Object array,
                           int index)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException
以 long 形式返回指定陣列物件中索引元件的值。

參數：
array - 陣列
index - 索引
返回：
指定陣列中索引元件的值
拋出：
NullPointerException - 如果指定物件為 null
IllegalArgumentException - 如果指定物件不是一個陣列，或者無法通過一個恆等或擴展轉換將索引元素轉換為返回型別
ArrayIndexOutOfBoundsException - 如果指定的 index 參數為負，或者它大於等於指定陣列的長度
另請參見：
get(java.lang.Object, int)

getFloat

public static float getFloat(Object array,
                             int index)
                      throws IllegalArgumentException,
                             ArrayIndexOutOfBoundsException
以 float 形式返回指定陣列物件中索引元件的值。

參數：
array - 陣列
index - 索引
返回：
指定陣列中索引元件的值
拋出：
NullPointerException - 如果指定物件為 null
IllegalArgumentException - 如果指定物件不是一個陣列，或者無法通過一個恆等或擴展轉換將索引元素轉換為返回型別
ArrayIndexOutOfBoundsException - 如果指定的 index 參數為負，或者它大於等於指定陣列的長度
另請參見：
get(java.lang.Object, int)

getDouble

public static double getDouble(Object array,
                               int index)
                        throws IllegalArgumentException,
                               ArrayIndexOutOfBoundsException
以 double 形式返回指定陣列物件中索引元件的值。

參數：
array - 陣列
index - 索引
返回：
指定陣列中索引元件的值
拋出：
NullPointerException - 如果指定物件為 null
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)
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。