Java コアリフレクション

クラス java.lang.reflect.Array

    package java.lang.reflect;

    public final class Array extends Object

Array クラスはインスタンス化できないクラスで、static メソッドをエクスポートしてプリミティブまたはコンポーネント型の Java 配列を生成し、配列コンポーネント値を獲得して設定します。

メソッド

newInstance

    public static Object newInstance(Class componentType, int length)

        throws NullPointerException, NegativeArraySizeException

指定のコンポーネント型および長さの新規配列を返します。配列は、等価な配列式のように生成されます。以下を参照してください:

    

        new componentType[length]

指定の componentType 引数が null の場合、メソッドは NullPointerException をスローします。

指定の length 引数が負の場合、メソッドは NegativeArraySizeException をスローします。

newInstance

    public static Object newInstance(Class componentType,

                                 int[] dimensions)

        throws NullPointerException, IllegalArgumentException,

            NegativeArraySizeException

指定のコンポーネント型および大きさの新規配列を返します。配列は、等価な配列式のように生成されます。以下を参照してください:

    

        new componentType[dimensions[0]][dimensions[1]]...

componentType 引数または dimensions 引数のいずれかが null の場合、メソッドは NullPointerException をスローします。

指定の dimensions 引数がゼロの大きさの配列の場合、または要求した大きさの数が実装がサポートする配列数の上限 (通常 255) を超える場合、メソッドは IllegalArgumentException をスローします。

指定の dimensions 配列に負の要素があると、メソッドは NegativeArraySizeException をスローします。

getLength

    public static int getLength(Object array)

        throws NullPointerException, IllegalArgumentException

指定した配列の長さを返します。

指定のオブジェクト引数が null の場合は、 NullPointerException をスローします。

指定のオブジェクト引数が配列でない場合は、 IllegalArgumentException をスローします。

get

    public static Object get(Object array, int index)

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付きコンポーネントの値を返します。値がプリミティブ型を持つ場合は、自動的にオブジェクトにラップされます。

処理手順は以下のとおりです:

指定のオブジェクトが null の場合、メソッドは NullPointerException をスローする。
指定のオブジェクトが配列でない場合、メソッドは IllegalArgumentException をスローする。
指定の index 引数が負でない場合、あるいは指定した配列の長さと同じかこれよりも大きい場合、メソッドは ArrayIndexOutOfBoundsException をスローする。
添え字付きコンポーネントの値が取り出される。配列のコンポーネント型がプリミティブの場合、値はオブジェクトにラップされる。ラップ値が返される。

より効率的な Array.get のプリミティブなものも提供されます。これらにはファイナルラッピング変換は不要です。これらについては、以下で説明します。

getBoolean

    public static boolean getBoolean(Object array, int index)

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクト内の添え字付き要素の値を、boolean として返します。手続きの詳細は、Array.get を参照してください。

添え字付きの値が boolean 型でないと、メソッドは IllegalArgumentException をスローします。

getByte

    public static byte getByte(Object array, int index)

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクト内の添え字付き要素の値を、byte として返します。手続きの詳細は、Array.get を参照してください。

添え字付きの値が byte 型でないと、メソッドは IllegalArgumentException をスローします。

getChar

    public static char getChar(Object array, int index)

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクト内の添え字付き要素の値を、char として返します。手続きの詳細は、Array.get を参照してください。

添え字付きの値が char 型でないと、メソッドはIllegalArgumentException をスローします。

getShort

    public static short getShort(Object array, int index)

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクト内の添え字付き要素の値を、short として返します。手続きの詳細は、Array.get を参照してください。

識別変換または拡張変換を使って、添え字付きの値を short に変換できないと、メソッドは IllegalArgumentException をスローします。

getInt

    public static int getInt(Object array, int index)

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクト内の添え字付き要素の値を、int として返します。手続きの詳細は、Array.get を参照してください。

識別変換または拡張変換を使って、添え字付きの値を int に変換できないと、メソッドは IllegalArgumentException をスローします。

getLong

    public static long getLong(Object array, int index)

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクト内の添え字付き要素の値を、long として返します。手続きの詳細は、Array.get を参照してください。

識別変換または拡張変換を使って、添え字付きの値を long に変換できないと、メソッドは IllegalArgumentException をスローします。

getFloat

    public static float getFloat(Object array, int index)

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクト内の添え字付き要素の値を、float として返します。手続きの詳細は、Array.get を参照してください。

識別変換または拡張変換を使って、添え字付きの値を float に変換できないと、メソッドは IllegalArgumentException をスローします。

getDouble

    public static double getDouble(Object array, int index)

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクト内の添え字付き要素の値を、double として返します。手続きの詳細は、Array.get を参照してください。

識別変換または拡張変換を使って、添え字付きの値を double に変換できないと、メソッドは IllegalArgumentException をスローします。

set

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

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付きコンポーネントを、指定の新規値に設定します。配列がプリミティブ型を持つ場合、新規値はまず最初に自動的にアンラップされます。

処理手順は以下のとおりです:

指定のオブジェクト引数が null の場合、メソッドは NullPointerException をスローする。
指定のオブジェクト引数が配列でない場合、メソッドは IllegalArgumentException をスローする。
指定の index 引数が負の場合、あるいは指定配列の長さと同じかこれよりも大きい場合、メソッドは ArrayIndexOutOfBoundsException をスローする。
配列がプリミティブコンポーネント型を持つ場合、新規オブジェクト値をプリミティブ型の値に変換するためにアンラッピング変換が試される。オブジェクトのパラメータが null の場合、NullPointerException をスローして、変換が失敗する。オブジェクトパラメータが標準 Java ラッパークラスのインスタンスでない場合、IllegalArgumentException をスローして、変換が失敗する。
アンラッピングのあとで、識別変換または拡張変換を使って、新規値を配列コンポーネント型の値に変換できない場合、メソッドは IllegalArgumentException をスローする。
添え字付きの配列コンポーネントは、アンラップおよび拡張した新規値に設定される。

より効率的な Array.set のプリミティブなものも提供されます。これらを使うと、ユーザコードで新規値をラップする必要がなくなります。これらの説明を以下に示します。

setBoolean

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

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付き要素を、指定の boolean 値に設定します。手続きの詳細は、Array.set を参照してください。

setByte

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

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付き要素を、指定の byte 値に設定します。手続きの詳細は、Array.set を参照してください。

setChar

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

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付き要素を、指定の char 値に設定します。手続きの詳細は、Array.set を参照してください。

setShort

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

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付き要素を、指定の short 値に設定します。手続きの詳細は、Array.set を参照してください。

setInt

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

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付き要素を、指定の int 値に設定します。手続きの詳細は、Array.set を参照してください。

setLong

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

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付き要素を、指定の long 値に設定します。手続きの詳細は、Array.set を参照してください。

setFloat

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

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付き要素を、指定の float 値に設定します。手続きの詳細は、Array.set を参照してください。

setDouble

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

        throws NullPointerException, IllegalArgumentException,

            ArrayIndexOutOfBoundsException

指定した配列オブジェクトの添え字付き要素を、指定の double 値に設定します。手続きの詳細は、Array.set を参照してください。

目次 | 前項目 | 次項目